calabash-android 0.4.7.pre6 → 0.4.7.pre7

data/test-server/instrumentation-backend/src/sh/calaba/org/codehaus/jackson/map/Serializers.java

@@ -0,0 +1,137 @@
+package sh.calaba.org.codehaus.jackson.map;
+
+import sh.calaba.org.codehaus.jackson.map.type.ArrayType;
+import sh.calaba.org.codehaus.jackson.map.type.CollectionLikeType;
+import sh.calaba.org.codehaus.jackson.map.type.CollectionType;
+import sh.calaba.org.codehaus.jackson.map.type.MapLikeType;
+import sh.calaba.org.codehaus.jackson.map.type.MapType;
+import sh.calaba.org.codehaus.jackson.type.JavaType;
+
+/**
+ * Interface that defines API for simple extensions that can provide additional serializers
+ * for various types. Access is by a single callback method; instance is to either return
+ * a configured {@link JsonSerializer} for specified type, or null to indicate that it
+ * does not support handling of the type. In latter case, further calls can be made
+ * for other providers; in former case returned serializer is used for handling of
+ * instances of specified type.
+ * 
+ * @since 1.7
+ */
+public interface Serializers
+{
+    /**
+     * Method called by serialization framework first time a serializer is needed for
+     * specified type, which is not of a container type (for which other methods are
+     * called).
+     *<p>
+     * Note: in version 1.7, this method was called to find serializers for all
+     * type, including container types.
+     * 
+     * @param type Fully resolved type of instances to serialize
+     * @param config Serialization configuration in use
+     * @param beanDesc Additional information about type; will always be of type
+     *    {@link sh.calaba.org.codehaus.jackson.map.introspect.BasicBeanDescription} (that is,
+     *    safe to cast to this more specific type)
+     * @param property Property that contains values to serialize
+     *    
+     * @return Configured serializer to use for the type; or null if implementation
+     *    does not recognize or support type
+     */
+    public JsonSerializer<?> findSerializer(SerializationConfig config,
+            JavaType type, BeanDescription beanDesc, BeanProperty property);
+
+    /**
+     * Method called by serialization framework first time a serializer is needed for
+     * specified array type.
+     * Implementation should return a serializer instance if it supports
+     * specified type; or null if it does not.
+     * 
+     * @since 1.8
+     */
+    public JsonSerializer<?> findArraySerializer(SerializationConfig config,
+            ArrayType type, BeanDescription beanDesc, BeanProperty property,
+            TypeSerializer elementTypeSerializer, JsonSerializer<Object> elementValueSerializer);
+
+    public JsonSerializer<?> findCollectionSerializer(SerializationConfig config,
+            CollectionType type, BeanDescription beanDesc, BeanProperty property,
+            TypeSerializer elementTypeSerializer, JsonSerializer<Object> elementValueSerializer);
+
+    public JsonSerializer<?> findCollectionLikeSerializer(SerializationConfig config,
+            CollectionLikeType type, BeanDescription beanDesc, BeanProperty property,
+            TypeSerializer elementTypeSerializer, JsonSerializer<Object> elementValueSerializer);
+    
+    public JsonSerializer<?> findMapSerializer(SerializationConfig config,
+            MapType type, BeanDescription beanDesc, BeanProperty property,
+            JsonSerializer<Object> keySerializer,
+            TypeSerializer elementTypeSerializer, JsonSerializer<Object> elementValueSerializer);
+
+    public JsonSerializer<?> findMapLikeSerializer(SerializationConfig config,
+            MapLikeType type, BeanDescription beanDesc, BeanProperty property,
+            JsonSerializer<Object> keySerializer,
+            TypeSerializer elementTypeSerializer, JsonSerializer<Object> elementValueSerializer);
+
+    /**
+     * Basic {@link Serializers} implementation that implements all methods but provides
+     * no serializers. Its main purpose is to serve as a base class so that
+     * sub-classes only need to override methods they need.
+     * 
+     * @since 1.9
+     */
+    public static class Base implements Serializers
+    {
+        @Override
+        public JsonSerializer<?> findSerializer(SerializationConfig config,
+                JavaType type, BeanDescription beanDesc, BeanProperty property)
+        {
+            return null;
+        }
+        
+        @Override
+        public JsonSerializer<?> findArraySerializer(SerializationConfig config,
+                ArrayType type, BeanDescription beanDesc, BeanProperty property,
+                TypeSerializer elementTypeSerializer, JsonSerializer<Object> elementValueSerializer)
+        {
+            return null;
+        }
+
+        @Override
+        public JsonSerializer<?> findCollectionSerializer(SerializationConfig config,
+                CollectionType type, BeanDescription beanDesc, BeanProperty property,
+                TypeSerializer elementTypeSerializer, JsonSerializer<Object> elementValueSerializer)
+        {
+            return null;
+        }
+
+        @Override
+        public JsonSerializer<?> findCollectionLikeSerializer(SerializationConfig config,
+                CollectionLikeType type, BeanDescription beanDesc, BeanProperty property,
+                TypeSerializer elementTypeSerializer, JsonSerializer<Object> elementValueSerializer)
+        {
+            return null;
+        }
+            
+        @Override
+        public JsonSerializer<?> findMapSerializer(SerializationConfig config,
+                MapType type, BeanDescription beanDesc, BeanProperty property,
+                JsonSerializer<Object> keySerializer,
+                TypeSerializer elementTypeSerializer, JsonSerializer<Object> elementValueSerializer)
+        {
+            return null;
+        }
+
+        @Override
+        public JsonSerializer<?> findMapLikeSerializer(SerializationConfig config,
+                MapLikeType type, BeanDescription beanDesc, BeanProperty property,
+                JsonSerializer<Object> keySerializer,
+                TypeSerializer elementTypeSerializer, JsonSerializer<Object> elementValueSerializer)
+        {
+            return null;
+        }
+    }
+
+    /**
+     * @deprecated As of 1.9, use {@link Base} instead
+     */
+    @Deprecated
+    public static class None extends Base { }
+}

data/test-server/instrumentation-backend/src/sh/calaba/org/codehaus/jackson/map/TypeDeserializer.java

@@ -0,0 +1,118 @@
+package sh.calaba.org.codehaus.jackson.map;
+
+import java.io.IOException;
+
+import sh.calaba.org.codehaus.jackson.JsonParser;
+import sh.calaba.org.codehaus.jackson.JsonProcessingException;
+import sh.calaba.org.codehaus.jackson.annotate.JsonTypeInfo.As;
+import sh.calaba.org.codehaus.jackson.map.jsontype.TypeIdResolver;
+
+/**
+ * Interface for deserializing type information from JSON content, to
+ * type-safely deserialize data into correct polymorphic instance
+ * (when type inclusion has been enabled for type handled).
+ *<p>
+ * Separate deserialization methods are needed because serialized
+ * form for inclusion mechanism {@link As#PROPERTY}
+ * is slighty different if value is not expressed as JSON Object:
+ * and as such both type deserializer and serializer need to
+ * JSON Object form (array, object or other (== scalar)) being
+ * used.
+ * 
+ * @since 1.5
+ * @author tatus
+ */
+public abstract class TypeDeserializer
+{
+    /*
+    /**********************************************************
+    /* Introspection
+    /**********************************************************
+     */
+
+    /**
+     * Accessor for type information inclusion method
+     * that deserializer uses; indicates how type information
+     * is (expected to be) embedded in JSON input.
+     */
+    public abstract As getTypeInclusion();
+
+    /**
+     * Name of property that contains type information, if
+     * property-based inclusion is used.
+     */
+    public abstract String getPropertyName();
+
+    /**
+     * Accessor for object that handles conversions between
+     * types and matching type ids.
+     */
+    public abstract TypeIdResolver getTypeIdResolver();
+
+    /**
+     * Accessor for "default implementation" type; optionally defined
+     * class to use in cases where type id is not
+     * accessible for some reason (either missing, or can not be
+     * resolved)
+     * 
+     * @since 1.9
+     */
+    public abstract Class<?> getDefaultImpl();
+    
+    /*
+    /*********************************************************
+    /* Type deserialization methods
+    /**********************************************************
+     */
+
+    /**
+     * Method called to let this type deserializer handle 
+     * deserialization of "typed" object, when value itself
+     * is serialized as JSON Object (regardless of Java type).
+     * Method needs to figure out intended
+     * polymorphic type, locate {@link JsonDeserializer} to use, and
+     * call it with JSON data to deserializer (which does not contain
+     * type information).
+     */
+    public abstract Object deserializeTypedFromObject(JsonParser jp, DeserializationContext ctxt)
+        throws IOException, JsonProcessingException;
+
+    /**
+     * Method called to let this type deserializer handle 
+     * deserialization of "typed" object, when value itself
+     * is serialized as JSON Array (regardless of Java type).
+     * Method needs to figure out intended
+     * polymorphic type, locate {@link JsonDeserializer} to use, and
+     * call it with JSON data to deserializer (which does not contain
+     * type information).
+     */
+    public abstract Object deserializeTypedFromArray(JsonParser jp, DeserializationContext ctxt)
+        throws IOException, JsonProcessingException;
+
+    /**
+     * Method called to let this type deserializer handle 
+     * deserialization of "typed" object, when value itself
+     * is serialized as a scalar JSON value (something other
+     * than Array or Object), regardless of Java type.
+     * Method needs to figure out intended
+     * polymorphic type, locate {@link JsonDeserializer} to use, and
+     * call it with JSON data to deserializer (which does not contain
+     * type information).
+     */
+    public abstract Object deserializeTypedFromScalar(JsonParser jp, DeserializationContext ctxt)
+        throws IOException, JsonProcessingException;
+
+    /**
+     * Method called to let this type deserializer handle 
+     * deserialization of "typed" object, when value itself
+     * may have been serialized using any kind of JSON value
+     * (Array, Object, scalar). Should only be called if JSON
+     * serialization is polymorphic (not Java type); for example when
+     * using JSON node representation, or "untyped" Java object
+     * (which may be Map, Collection, wrapper/primitive etc).
+     */
+    public abstract Object deserializeTypedFromAny(JsonParser jp, DeserializationContext ctxt)
+        throws IOException, JsonProcessingException;
+
+}
+    

data/test-server/instrumentation-backend/src/sh/calaba/org/codehaus/jackson/map/TypeSerializer.java

@@ -0,0 +1,164 @@
+package sh.calaba.org.codehaus.jackson.map;
+
+import java.io.IOException;
+
+import sh.calaba.org.codehaus.jackson.JsonGenerator;
+import sh.calaba.org.codehaus.jackson.JsonProcessingException;
+import sh.calaba.org.codehaus.jackson.annotate.JsonTypeInfo;
+import sh.calaba.org.codehaus.jackson.map.jsontype.TypeIdResolver;
+
+/**
+ * Interface for serializing type information regarding instances of specified
+ * base type (super class), so that exact subtype can be properly deserialized
+ * later on. These instances are to be called by regular
+ * {@link sh.calaba.org.codehaus.jackson.map.JsonSerializer}s using proper contextual
+ * calls, to add type information using mechanism type serializer was
+ * configured with.
+ * 
+ * @since 1.5
+ * @author tatus
+ */
+public abstract class TypeSerializer
+{
+    /*
+    /**********************************************************
+    /* Introspection
+    /**********************************************************
+     */
+
+    /**
+     * Accessor for type information inclusion method
+     * that serializer uses; indicates how type information
+     * is embedded in resulting JSON.
+     */
+    public abstract JsonTypeInfo.As getTypeInclusion();
+
+    /**
+     * Name of property that contains type information, if
+     * property-based inclusion is used.
+     */
+    public abstract String getPropertyName();
+    
+    /**
+     * Accessor for object that handles conversions between
+     * types and matching type ids.
+     */
+    public abstract TypeIdResolver getTypeIdResolver();
+    
+    /*
+    /**********************************************************
+    /* Type serialization methods
+    /**********************************************************
+     */
+    
+    /**
+     * Method called to write initial part of type information for given
+     * value, when it will be output as scalar JSON value (not as JSON
+     * Object or Array).
+     * This means that the context after call can not be that of JSON Object;
+     * it may be Array or root context.
+     * 
+     * @param value Value that will be serialized, for which type information is
+     *   to be written
+     * @param jgen Generator to use for writing type information
+     */
+    public abstract void writeTypePrefixForScalar(Object value, JsonGenerator jgen)
+        throws IOException, JsonProcessingException;
+
+    /**
+     * Method called to write initial part of type information for given
+     * value, when it will be output as JSON Object value (not as JSON
+     * Array or scalar).
+     * This means that context after call must be JSON Object, meaning that
+     * caller can then proceed to output field entries.
+     * 
+     * @param value Value that will be serialized, for which type information is
+     *   to be written
+     * @param jgen Generator to use for writing type information
+     */
+    public abstract void writeTypePrefixForObject(Object value, JsonGenerator jgen)
+        throws IOException, JsonProcessingException;
+
+    /**
+     * Method called to write initial part of type information for given
+     * value, when it will be output as JSON Array value (not as JSON
+     * Object or scalar).
+     * This means that context after call must be JSON Array, that is, there
+     * must be an open START_ARRAY to write contents in.
+     * 
+     * @param value Value that will be serialized, for which type information is
+     *   to be written
+     * @param jgen Generator to use for writing type information
+     */
+    public abstract void writeTypePrefixForArray(Object value, JsonGenerator jgen)
+        throws IOException, JsonProcessingException;
+    
+    /**
+     * Method called after value has been serialized, to close any scopes opened
+     * by earlier matching call to {@link #writeTypePrefixForScalar}.
+     * Actual action to take may depend on various factors, but has to match with
+     * action {@link #writeTypePrefixForScalar} did (close array or object; or do nothing).
+     */
+    public abstract void writeTypeSuffixForScalar(Object value, JsonGenerator jgen)
+        throws IOException, JsonProcessingException;
+
+    /**
+     * Method called after value has been serialized, to close any scopes opened
+     * by earlier matching call to {@link #writeTypePrefixForObject}.
+     * It needs to write closing END_OBJECT marker, and any other decoration
+     * that needs to be matched.
+     */
+    public abstract void writeTypeSuffixForObject(Object value, JsonGenerator jgen)
+        throws IOException, JsonProcessingException;
+
+    /**
+     * Method called after value has been serialized, to close any scopes opened
+     * by earlier matching call to {@link #writeTypeSuffixForScalar}.
+     * It needs to write closing END_ARRAY marker, and any other decoration
+     * that needs to be matched.
+     */
+    public abstract void writeTypeSuffixForArray(Object value, JsonGenerator jgen)
+        throws IOException, JsonProcessingException;
+
+    /**
+     * Alternative version of the prefix-for-scalar method, which is given
+     * actual type to use (instead of using exact type of the value); typically
+     * a super type of actual value type
+     * 
+     * @since 1.8
+     */
+    public void writeTypePrefixForScalar(Object value, JsonGenerator jgen,
+            Class<?> type)
+        throws IOException, JsonProcessingException
+    {
+        writeTypePrefixForScalar(value, jgen);
+    }
+
+    /**
+     * Alternative version of the prefix-for-object method, which is given
+     * actual type to use (instead of using exact type of the value); typically
+     * a super type of actual value type
+     * 
+     * @since 1.8
+     */
+    public void writeTypePrefixForObject(Object value, JsonGenerator jgen,
+            Class<?> type)
+        throws IOException, JsonProcessingException
+    {
+        writeTypePrefixForObject(value, jgen);
+    }
+
+    /**
+     * Alternative version of the prefix-for-array method, which is given
+     * actual type to use (instead of using exact type of the value); typically
+     * a super type of actual value type
+     * 
+     * @since 1.8
+     */
+    public void writeTypePrefixForArray(Object value, JsonGenerator jgen,
+            Class<?> type)
+        throws IOException, JsonProcessingException
+    {
+        writeTypePrefixForArray(value, jgen);
+    }
+}

data/test-server/instrumentation-backend/src/sh/calaba/org/codehaus/jackson/map/annotate/JacksonInject.java

@@ -0,0 +1,30 @@
+package sh.calaba.org.codehaus.jackson.map.annotate;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+import sh.calaba.org.codehaus.jackson.annotate.JacksonAnnotation;
+
+/**
+ * Jackson-specific annotation used for indicating that value of
+ * annotated property will be "injected", i.e. set based on value
+ * configured by <code>ObjectMapper</code> (usually on per-call basis).
+ * Usually property is not deserialized from JSON, although it possible
+ * to have injected value as default and still allow optional override
+ * from JSON.
+ * 
+ * @since 1.9
+ */
+@Target({ElementType.METHOD, ElementType.FIELD, ElementType.PARAMETER})
+@Retention(RetentionPolicy.RUNTIME)
+@JacksonAnnotation
+public @interface JacksonInject
+{
+    /**
+     * Logical id of the value to inject; if not specified (or specified
+     * as empty String), will use id based on declared type of property.
+     */
+    public String value() default "";
+}