calabash-android 0.4.7.pre6 → 0.4.7.pre7

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

@@ -0,0 +1,190 @@
+package sh.calaba.org.codehaus.jackson.map;
+
+import java.io.IOException;
+import java.util.Iterator;
+import java.util.NoSuchElementException;
+
+import sh.calaba.org.codehaus.jackson.JsonParser;
+import sh.calaba.org.codehaus.jackson.JsonStreamContext;
+import sh.calaba.org.codehaus.jackson.JsonToken;
+import sh.calaba.org.codehaus.jackson.type.JavaType;
+
+/**
+ * Iterator exposed by {@link ObjectMapper} when binding sequence of
+ * objects. Extension is done to allow more convenient exposing of
+ * {@link IOException} (which basic {@link Iterator} does not expose)
+ * 
+ * @since 1.8
+ */
+public class MappingIterator<T> implements Iterator<T>
+{
+    protected final static MappingIterator<?> EMPTY_ITERATOR =
+        new MappingIterator<Object>(null, null, null, null, false, null);
+    
+    protected final JavaType _type;
+
+    protected final DeserializationContext _context;
+    
+    protected final JsonDeserializer<T> _deserializer;
+
+    protected JsonParser _parser;
+    
+    /**
+     * Flag that indicates whether input {@link JsonParser} should be closed
+     * when we are done or not; generally only called when caller did not
+     * pass JsonParser.
+     */
+    protected final boolean _closeParser;
+
+    /**
+     * Flag that is set when we have determined what {@link #hasNextValue()}
+     * should value; reset when {@link #nextValue} is called
+     */
+    protected boolean _hasNextChecked;
+    
+    /**
+     * If not null, "value to update" instead of creating a new instance
+     * for each call.
+     */
+    protected final T _updatedValue;
+
+    protected MappingIterator(JavaType type, JsonParser jp, DeserializationContext ctxt,
+            JsonDeserializer<?> deser)
+    {
+        this(type, jp, ctxt, deser, true, null);
+    }
+    
+    /**
+     * @since 1.9.3
+     */
+    @SuppressWarnings("unchecked")
+    protected MappingIterator(JavaType type, JsonParser jp, DeserializationContext ctxt, JsonDeserializer<?> deser,
+            boolean closeParser, Object valueToUpdate)
+    {
+        _type = type;
+        _parser = jp;
+        _context = ctxt;
+        _deserializer = (JsonDeserializer<T>) deser;
+
+        /* One more thing: if we are at START_ARRAY (but NOT root-level
+         * one!), advance to next token (to allow matching END_ARRAY)
+         */
+        if (jp != null && jp.getCurrentToken() == JsonToken.START_ARRAY) {
+            JsonStreamContext sc = jp.getParsingContext();
+            // safest way to skip current token is to clear it (so we'll advance soon)
+            if (!sc.inRoot()) {
+                jp.clearCurrentToken();
+            }
+        }
+        _closeParser = closeParser;
+        if (valueToUpdate == null) {
+            _updatedValue = null;
+        } else {
+            _updatedValue = (T) valueToUpdate;
+        }
+    }
+
+    @SuppressWarnings("unchecked")
+    protected static <T> MappingIterator<T> emptyIterator() {
+        return (MappingIterator<T>) EMPTY_ITERATOR;
+    }
+    
+    /*
+    /**********************************************************
+    /* Basic iterator impl
+    /**********************************************************
+     */
+
+    @Override
+    public boolean hasNext()
+    {
+        try {
+            return hasNextValue();
+        } catch (JsonMappingException e) {
+            throw new RuntimeJsonMappingException(e.getMessage(), e);
+        } catch (IOException e) {
+            throw new RuntimeException(e.getMessage(), e);
+        }
+    }
+
+    @Override
+    public T next()
+    {
+        try {
+            return nextValue();
+        } catch (JsonMappingException e) {
+            throw new RuntimeJsonMappingException(e.getMessage(), e);
+        } catch (IOException e) {
+            throw new RuntimeException(e.getMessage(), e);
+        }
+    }
+
+    @Override public void remove() {
+        throw new UnsupportedOperationException();
+    }
+
+    /*
+    /**********************************************************
+    /* Extended API
+    /**********************************************************
+     */
+
+    /**
+     * Equivalent of {@link #next} but one that may throw checked
+     * exceptions from Jackson due to invalid input.
+     */
+    public boolean hasNextValue() throws IOException
+    {
+        if (_parser == null) {
+            return false;
+        }
+        if (!_hasNextChecked) {
+            JsonToken t = _parser.getCurrentToken();
+            _hasNextChecked = true;
+            if (t == null) { // un-initialized or cleared; find next
+                t = _parser.nextToken();
+                // If EOF, no more
+                if (t == null) {
+                    JsonParser jp = _parser;
+                    _parser = null;
+                    if (_closeParser) {
+                        jp.close();
+                    }
+                    return false;
+                }
+                /* And similarly if we hit END_ARRAY; except that we won't close parser
+                 * (because it's not a root-level iterator)
+                 */
+                if (t == JsonToken.END_ARRAY) {
+                    return false;
+                }
+            }
+        }
+        return true;
+    }
+    
+    public T nextValue() throws IOException
+    {
+        // caller should always call 'hasNext[Value]' first; but let's ensure:
+        if (!_hasNextChecked) {
+            if (!hasNextValue()) {
+                throw new NoSuchElementException();
+            }
+        }
+        if (_parser == null) {
+            throw new NoSuchElementException();
+        }
+        _hasNextChecked = false;
+        T result;
+        
+        if (_updatedValue == null) {
+            result = _deserializer.deserialize(_parser, _context);
+        } else{
+            _deserializer.deserialize(_parser, _context, _updatedValue);
+            result = _updatedValue;
+        }
+        // Need to consume the token too
+        _parser.clearCurrentToken();
+        return result;
+    }
+}

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

@@ -0,0 +1,81 @@
+/* Jackson JSON-processor.
+ *
+ * Copyright (c) 2007- Tatu Saloranta, tatu.saloranta@iki.fi
+ *
+ * Licensed under the License specified in file LICENSE, included with
+ * the source code and binary code bundles.
+ * You may not use this file except in compliance with the License.
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package sh.calaba.org.codehaus.jackson.map;
+
+import java.io.IOException;
+
+import sh.calaba.org.codehaus.jackson.JsonFactory;
+import sh.calaba.org.codehaus.jackson.ObjectCodec;
+import sh.calaba.org.codehaus.jackson.format.InputAccessor;
+import sh.calaba.org.codehaus.jackson.format.MatchStrength;
+
+/**
+ * Sub-class of {@link JsonFactory} that will create a proper
+ * {@link ObjectCodec} to allow seamless conversions between
+ * Json content and Java objects (POJOs).
+ * The only addition to regular {@link JsonFactory} currently
+ * is that {@link ObjectMapper} is constructed and passed as
+ * the codec to use.
+ */
+public class MappingJsonFactory
+    extends JsonFactory
+{
+    public MappingJsonFactory()
+    {
+        this(null);
+    }
+
+    public MappingJsonFactory(ObjectMapper mapper)
+    {
+        super(mapper);
+        if (mapper == null) {
+            setCodec(new ObjectMapper(this));
+        }
+    }
+
+    /**
+     * We'll override the method to return more specific type; co-variance
+     * helps here
+     */
+    @Override
+    public final ObjectMapper getCodec() { return (ObjectMapper) _objectCodec; }
+
+    /*
+    /**********************************************************
+    /* Format detection functionality (since 1.8)
+    /**********************************************************
+     */
+    
+    /**
+     * Sub-classes need to override this method (as of 1.8)
+     */
+    @Override
+    public String getFormatName()
+    {
+        /* since non-JSON factories typically should not extend this class,
+         * let's just always return JSON as name.
+         */
+        return FORMAT_NAME_JSON;
+    }
+
+    /**
+     * Sub-classes need to override this method (as of 1.8)
+     */
+    @Override
+    public MatchStrength hasFormat(InputAccessor acc) throws IOException
+    {
+        return hasJSONFormat(acc);
+    }
+}

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

@@ -0,0 +1,255 @@
+package sh.calaba.org.codehaus.jackson.map;
+
+import sh.calaba.org.codehaus.jackson.JsonGenerator;
+import sh.calaba.org.codehaus.jackson.JsonParser;
+import sh.calaba.org.codehaus.jackson.Version;
+import sh.calaba.org.codehaus.jackson.Versioned;
+import sh.calaba.org.codehaus.jackson.map.deser.BeanDeserializerModifier;
+import sh.calaba.org.codehaus.jackson.map.deser.ValueInstantiators;
+import sh.calaba.org.codehaus.jackson.map.ser.BeanSerializerModifier;
+import sh.calaba.org.codehaus.jackson.map.type.TypeModifier;
+
+/**
+ * Simple interface for extensions that can be registered with {@link ObjectMapper}
+ * to provide a well-defined set of extensions to default functionality; such as
+ * support for new data types.
+ *
+ * @since 1.7
+ */
+public abstract class Module
+    implements Versioned
+{
+    /*
+    /**********************************************************
+    /* Simple accessors
+    /**********************************************************
+     */
+    
+    /**
+     * Method that returns identifier for module; this can be used by Jackson
+     * for informational purposes, as well as in associating extensions with
+     * module that provides them.
+     */
+    public abstract String getModuleName();
+
+    /**
+     * Method that returns version of this module. Can be used by Jackson for
+     * informational purposes.
+     */
+    @Override
+    public abstract Version version();
+
+    /*
+    /**********************************************************
+    /* Life-cycle: registration
+    /**********************************************************
+     */
+    
+    /**
+     * Method called by {@link ObjectMapper} when module is registered.
+     * It is called to let module register functionality it provides,
+     * using callback methods passed-in context object exposes.
+     */
+    public abstract void setupModule(SetupContext context);
+    
+    /*
+    /**********************************************************
+    /* Helper types
+    /**********************************************************
+     */
+
+    /**
+     * Interface Jackson exposes to modules for purpose of registering
+     * extended functionality.
+     */
+    public interface SetupContext
+    {
+        /*
+        /**********************************************************
+        /* Simple accessors
+        /**********************************************************
+         */
+        
+        /**
+         * Method that returns version information about {@link ObjectMapper} 
+         * that implements this context. Modules can use this to choose
+         * different settings or initialization order; or even decide to fail
+         * set up completely if version is compatible with module.
+         */
+        public Version getMapperVersion();
+
+        /**
+         * Method that returns current deserialization configuration
+         * settings. Since modules may be interested in these settings,
+         * caller should make sure to make changes to settings before
+         * module registrations.
+         */
+        public DeserializationConfig getDeserializationConfig();
+
+        /**
+         * Method that returns current serialization configuration
+         * settings. Since modules may be interested in these settings,
+         * caller should make sure to make changes to settings before
+         * module registrations.
+         * 
+         * @since 1.7.1 (1.7.0 unfortunately had a typo in method name!)
+         */
+        public SerializationConfig getSerializationConfig();
+
+        /**
+         * @since 1.9.0
+         */
+        public boolean isEnabled(DeserializationConfig.Feature f);
+
+        /**
+         * @since 1.9.0
+         */
+        public boolean isEnabled(SerializationConfig.Feature f);
+
+        /**
+         * @since 1.9.0
+         */
+        public boolean isEnabled(JsonParser.Feature f);
+
+        /**
+         * @since 1.9.0
+         */
+        public boolean isEnabled(JsonGenerator.Feature f);
+        
+        /*
+        /**********************************************************
+        /* Handler registration; serializers/deserializers
+        /**********************************************************
+         */
+        
+        /**
+         * Method that module can use to register additional deserializers to use for
+         * handling types.
+         * 
+         * @param d Object that can be called to find deserializer for types supported
+         *   by module (null returned for non-supported types)
+         */
+        public void addDeserializers(Deserializers d);
+
+        /**
+         * Method that module can use to register additional deserializers to use for
+         * handling Map key values (which are separate from value deserializers because
+         * they are always serialized from String values)
+         *
+         * @since 1.8
+         */
+        public void addKeyDeserializers(KeyDeserializers s);
+        
+        /**
+         * Method that module can use to register additional serializers to use for
+         * handling types.
+         * 
+         * @param s Object that can be called to find serializer for types supported
+         *   by module (null returned for non-supported types)
+         */
+        public void addSerializers(Serializers s);
+
+        /**
+         * Method that module can use to register additional serializers to use for
+         * handling Map key values (which are separate from value serializers because
+         * they must write <code>JsonToken.FIELD_NAME</code> instead of String value).
+         *
+         * @since 1.8
+         */
+        public void addKeySerializers(Serializers s);
+
+        /*
+        /**********************************************************
+        /* Handler registration; other
+        /**********************************************************
+         */
+        
+        /**
+         * Method that module can use to register additional modifier objects to
+         * customize configuration and construction of bean deserializers.
+         * 
+         * @param mod Modifier to register
+         */
+        public void addBeanDeserializerModifier(BeanDeserializerModifier mod);
+
+        /**
+         * Method that module can use to register additional modifier objects to
+         * customize configuration and construction of bean serializers.
+         * 
+         * @param mod Modifier to register
+         */
+        public void addBeanSerializerModifier(BeanSerializerModifier mod);
+
+        /**
+         * Method that module can use to register additional
+         * {@link AbstractTypeResolver} instance, to handle resolution of
+         * abstract to concrete types (either by defaulting, or by materializing).
+         * 
+         * @param resolver Resolver to add.
+         * 
+         * @since 1.8
+         */
+        public void addAbstractTypeResolver(AbstractTypeResolver resolver);
+
+        /**
+         * Method that module can use to register additional
+         * {@link TypeModifier} instance, which can augment {@link sh.calaba.org.codehaus.jackson.type.JavaType}
+         * instances constructed by {@link sh.calaba.org.codehaus.jackson.map.type.TypeFactory}.
+         * 
+         * @param modifier to add
+         * 
+         * @since 1.8
+         */
+        public void addTypeModifier(TypeModifier modifier);
+
+        /**
+         * Method that module can use to register additional {@link sh.calaba.org.codehaus.jackson.map.deser.ValueInstantiator}s,
+         * by adding {@link ValueInstantiators} object that gets called when 
+         * instantatiator is needed by a deserializer.
+         * 
+         * @param instantiators Object that can provide {@link sh.calaba.org.codehaus.jackson.map.deser.ValueInstantiator}s for
+         *    constructing POJO values during deserialization
+         * 
+         * @since 1.9
+         */
+        public void addValueInstantiators(ValueInstantiators instantiators);
+        
+        /**
+         * Method for registering specified {@link AnnotationIntrospector} as the highest
+         * priority introspector (will be chained with existing introspector(s) which
+         * will be used as fallbacks for cases this introspector does not handle)
+         * 
+         * @param ai Annotation introspector to register.
+         */
+        public void insertAnnotationIntrospector(AnnotationIntrospector ai);
+
+        /**
+         * Method for registering specified {@link AnnotationIntrospector} as the lowest
+         * priority introspector, chained with existing introspector(s) and called
+         * as fallback for cases not otherwise handled.
+         * 
+         * @param ai Annotation introspector to register.
+         */
+        public void appendAnnotationIntrospector(AnnotationIntrospector ai);
+
+        /**
+         * Method used for defining mix-in annotations to use for augmenting
+         * specified class or interface.
+         * All annotations from
+         * <code>mixinSource</code> are taken to override annotations
+         * that <code>target</code> (or its supertypes) has.
+         *<p>
+         * Note: mix-ins are registered both for serialization and deserialization
+         * (which can be different internally).
+         *<p>
+         * Note: currently only one set of mix-in annotations can be defined for
+         * a single class; so if multiple modules register mix-ins, highest
+         * priority one (last one registered) will have priority over other modules.
+         *
+         * @param target Class (or interface) whose annotations to effectively override
+         * @param mixinSource Class (or interface) whose annotations are to
+         *   be "added" to target's annotations, overriding as necessary
+         */
+        public void setMixInAnnotations(Class<?> target, Class<?> mixinSource);
+    }
+}