Return-Path: X-Original-To: archive-asf-public-internal@cust-asf2.ponee.io Delivered-To: archive-asf-public-internal@cust-asf2.ponee.io Received: from cust-asf.ponee.io (cust-asf.ponee.io [163.172.22.183]) by cust-asf2.ponee.io (Postfix) with ESMTP id D98AB200C4A for ; Sun, 2 Apr 2017 19:45:45 +0200 (CEST) Received: by cust-asf.ponee.io (Postfix) id D8716160BAE; Sun, 2 Apr 2017 17:45:45 +0000 (UTC) Delivered-To: archive-asf-public@cust-asf.ponee.io Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by cust-asf.ponee.io (Postfix) with SMTP id 38438160BC9 for ; Sun, 2 Apr 2017 19:45:44 +0200 (CEST) Received: (qmail 14800 invoked by uid 500); 2 Apr 2017 17:45:43 -0000 Mailing-List: contact commits-help@polygene.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@polygene.apache.org Delivered-To: mailing list commits@polygene.apache.org Received: (qmail 13728 invoked by uid 99); 2 Apr 2017 17:45:42 -0000 Received: from git1-us-west.apache.org (HELO git1-us-west.apache.org) (140.211.11.23) by apache.org (qpsmtpd/0.29) with ESMTP; Sun, 02 Apr 2017 17:45:42 +0000 Received: by git1-us-west.apache.org (ASF Mail Server at git1-us-west.apache.org, from userid 33) id CC15DE117B; Sun, 2 Apr 2017 17:45:42 +0000 (UTC) Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit From: paulmerlin@apache.org To: commits@polygene.apache.org Date: Sun, 02 Apr 2017 17:46:30 -0000 Message-Id: <0d5d01022bf84cb99e4b2e3e681a66f0@git.apache.org> In-Reply-To: <0088a29e2e0d476a907e84190e3d8c97@git.apache.org> References: <0088a29e2e0d476a907e84190e3d8c97@git.apache.org> X-Mailer: ASF-Git Admin Mailer Subject: [50/51] [abbrv] polygene-java git commit: Minor documentation fixes archived-at: Sun, 02 Apr 2017 17:45:46 -0000 Minor documentation fixes POLYGENE-231 Project: http://git-wip-us.apache.org/repos/asf/polygene-java/repo Commit: http://git-wip-us.apache.org/repos/asf/polygene-java/commit/baba8c09 Tree: http://git-wip-us.apache.org/repos/asf/polygene-java/tree/baba8c09 Diff: http://git-wip-us.apache.org/repos/asf/polygene-java/diff/baba8c09 Branch: refs/heads/serialization-3.0 Commit: baba8c09c8c4c5596889c6ee01d02ee1c2b4ea77 Parents: b7f3035 Author: Paul Merlin Authored: Mon Mar 13 15:48:29 2017 +0100 Committer: Paul Merlin Committed: Sun Apr 2 19:16:24 2017 +0200 ---------------------------------------------------------------------- core/api/src/docs/configuration.txt | 7 +- .../apache/polygene/api/common/UseDefaults.java | 2 +- .../api/value/DocumentationSupport.java | 3 +- .../AbstractCollectionSerializationTest.java | 76 ++++++++++---------- .../AbstractPlainValueSerializationTest.java | 2 +- ...AbstractValueCompositeSerializationTest.java | 2 +- 6 files changed, 45 insertions(+), 47 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/polygene-java/blob/baba8c09/core/api/src/docs/configuration.txt ---------------------------------------------------------------------- diff --git a/core/api/src/docs/configuration.txt b/core/api/src/docs/configuration.txt index 2d9281e..9f14b62 100644 --- a/core/api/src/docs/configuration.txt +++ b/core/api/src/docs/configuration.txt @@ -49,11 +49,11 @@ identifiable configuration. That will trigger the reading attempts of the suppor configuration is parsed from the file system it is written to the Entity Store, and if the Entity Store is not ephemeral, then on the next start, any changes to the configuration will NOT be detected, and will simply be ignored. -To be able to read JSON, YAML and XML configuration, you must configure a ValueSerialization system that supports +To be able to read JSON, YAML and XML configuration, you must configure a Serialization system that supports the configuration format that you want to use. -* extension/valueserialization-jackson supports JSON -* extension/valueserialization-stax supports XML +* extension/serialization-javaxjson supports JSON +* extension/serialization-javaxxml supports XML == Support for Complex Types == Since the regular Value Serialization platform is used, for JSON, YAML and XML, the configuration can contain @@ -84,4 +84,3 @@ must be called. Example; source=core/api/src/test/java/org/apache/polygene/api/configuration/MailService.java tag=write -------------- - http://git-wip-us.apache.org/repos/asf/polygene-java/blob/baba8c09/core/api/src/main/java/org/apache/polygene/api/common/UseDefaults.java ---------------------------------------------------------------------- diff --git a/core/api/src/main/java/org/apache/polygene/api/common/UseDefaults.java b/core/api/src/main/java/org/apache/polygene/api/common/UseDefaults.java index 8876ae7..bf8f5eb 100644 --- a/core/api/src/main/java/org/apache/polygene/api/common/UseDefaults.java +++ b/core/api/src/main/java/org/apache/polygene/api/common/UseDefaults.java @@ -53,7 +53,7 @@ import java.lang.annotation.Target; *

* The @UseDefaults annotation can also have a value in its declaration. This value is used, * unless it is overridden in the assembly (see below). Java does not support generic types of annotation values, - * so it accepts String values, which are deserialized from JSON using the ValueSerialization SPI. This allows + * so it accepts String values, which are deserialized from JSON using the Serialization SPI. This allows * for (albeit somewhat tedious) any object type to have a default value declared on it. If the property type is * String, then no value deserialization is done. *

http://git-wip-us.apache.org/repos/asf/polygene-java/blob/baba8c09/core/api/src/test/java/org/apache/polygene/api/value/DocumentationSupport.java ---------------------------------------------------------------------- diff --git a/core/api/src/test/java/org/apache/polygene/api/value/DocumentationSupport.java b/core/api/src/test/java/org/apache/polygene/api/value/DocumentationSupport.java index 2f55c83..245cc16 100644 --- a/core/api/src/test/java/org/apache/polygene/api/value/DocumentationSupport.java +++ b/core/api/src/test/java/org/apache/polygene/api/value/DocumentationSupport.java @@ -30,7 +30,6 @@ import org.apache.polygene.api.injection.scope.Service; import org.apache.polygene.api.property.Property; import org.apache.polygene.api.serialization.Deserializer; import org.apache.polygene.api.serialization.Serializer; -import org.apache.polygene.bootstrap.AssemblyException; import org.apache.polygene.bootstrap.ModuleAssembly; import org.apache.polygene.test.AbstractPolygeneTest; import org.junit.Test; @@ -64,7 +63,7 @@ public class DocumentationSupport extends AbstractPolygeneTest @Test // START SNIPPET: default - public void defaultValueSerialization() + public void defaultSerialization() { SomeValue someValue = someNewValueInstance(); // (3) String json = someValue.toString(); // (4) http://git-wip-us.apache.org/repos/asf/polygene-java/blob/baba8c09/core/testsupport/src/main/java/org/apache/polygene/test/serialization/AbstractCollectionSerializationTest.java ---------------------------------------------------------------------- diff --git a/core/testsupport/src/main/java/org/apache/polygene/test/serialization/AbstractCollectionSerializationTest.java b/core/testsupport/src/main/java/org/apache/polygene/test/serialization/AbstractCollectionSerializationTest.java index 474ed1a..a78c3fa 100644 --- a/core/testsupport/src/main/java/org/apache/polygene/test/serialization/AbstractCollectionSerializationTest.java +++ b/core/testsupport/src/main/java/org/apache/polygene/test/serialization/AbstractCollectionSerializationTest.java @@ -51,7 +51,7 @@ import static org.junit.Assert.assertArrayEquals; import static org.junit.Assert.assertEquals; /** - * Assert that ValueSerialization behaviour on Collections and Maps is correct. + * Assert that Serialization behaviour on Collections and Maps is correct. */ public class AbstractCollectionSerializationTest extends AbstractPolygeneTest @@ -65,7 +65,7 @@ public class AbstractCollectionSerializationTest @Service @SuppressWarnings( "ProtectedField" ) - protected Serialization stateSerialization; + protected Serialization serialization; @Test public void givenPrimitiveArrayWithIntsWhenSerializingAndDeserializingExpectEquals() @@ -75,9 +75,9 @@ public class AbstractCollectionSerializationTest { 23, 42, -23, -42 }; - String output = stateSerialization.serialize( primitiveArray ); + String output = serialization.serialize( primitiveArray ); System.out.println( output ); - int[] deserialized = stateSerialization.deserialize( module, int[].class, output ); + int[] deserialized = serialization.deserialize( module, int[].class, output ); assertArrayEquals( primitiveArray, deserialized ); } @@ -89,9 +89,9 @@ public class AbstractCollectionSerializationTest { 9, null, -12, -12, 127, -128, 73 }; - String output = stateSerialization.serialize( array ); + String output = serialization.serialize( array ); System.out.println( output ); - Byte[] deserialized = stateSerialization.deserialize( module, Byte[].class, output ); + Byte[] deserialized = serialization.deserialize( module, Byte[].class, output ); assertArrayEquals( array, deserialized ); } @@ -99,10 +99,10 @@ public class AbstractCollectionSerializationTest public void givenIterableTypeWithByteAndNullElementWhenSerializingAndDeserializingExpectEquals() throws Exception { - String output = stateSerialization.serialize( new AdHocIterable<>( byteCollection() ) ); + String output = serialization.serialize( new AdHocIterable<>( byteCollection() ) ); System.out.println( output ); CollectionType collectionType = CollectionType.listOf( ValueType.BYTE ); - List list = stateSerialization.deserialize( module, collectionType, output ); + List list = serialization.deserialize( module, collectionType, output ); assertEquals( byteCollection(), list ); } @@ -110,10 +110,10 @@ public class AbstractCollectionSerializationTest public void givenCollectionTypeWithByteAndNullElementWhenSerializingAndDeserializingExpectEquals() throws Exception { - String output = stateSerialization.serialize( byteCollection() ); + String output = serialization.serialize( byteCollection() ); System.out.println( output ); CollectionType collectionType = CollectionType.setOf( ValueType.BYTE ); - Set list = stateSerialization.deserialize( module, collectionType, output ); + Set list = serialization.deserialize( module, collectionType, output ); assertEquals( new LinkedHashSet<>( byteCollection() ), list ); } @@ -121,10 +121,10 @@ public class AbstractCollectionSerializationTest public void givenCollectionTypeWithCharacterAndNullElementWhenSerializingAndDeserializingExpectEquals() throws Exception { - String output = stateSerialization.serialize( characterCollection() ); + String output = serialization.serialize( characterCollection() ); System.out.println( output ); CollectionType collectionType = CollectionType.listOf( ValueType.CHARACTER ); - List list = stateSerialization.deserialize( module, collectionType, output ); + List list = serialization.deserialize( module, collectionType, output ); assertEquals( characterCollection(), list ); } @@ -132,10 +132,10 @@ public class AbstractCollectionSerializationTest public void givenCollectionTypeWithShortAndNullElementWhenSerializingAndDeserializingExpectEquals() throws Exception { - String output = stateSerialization.serialize( shortCollection() ); + String output = serialization.serialize( shortCollection() ); System.out.println( output ); CollectionType collectionType = CollectionType.listOf( ValueType.SHORT ); - List list = stateSerialization.deserialize( module, collectionType, output ); + List list = serialization.deserialize( module, collectionType, output ); assertEquals( shortCollection(), list ); } @@ -143,10 +143,10 @@ public class AbstractCollectionSerializationTest public void givenCollectionTypeWithIntegerAndNullElementWhenSerializingAndDeserializingExpectEquals() throws Exception { - String output = stateSerialization.serialize( integerCollection() ); + String output = serialization.serialize( integerCollection() ); System.out.println( output ); CollectionType collectionType = CollectionType.listOf( ValueType.INTEGER ); - List list = stateSerialization.deserialize( module, collectionType, output ); + List list = serialization.deserialize( module, collectionType, output ); assertEquals( integerCollection(), list ); } @@ -154,10 +154,10 @@ public class AbstractCollectionSerializationTest public void givenCollectionTypeWithLongAndNullElementWhenSerializingAndDeserializingExpectEquals() throws Exception { - String output = stateSerialization.serialize( longCollection() ); + String output = serialization.serialize( longCollection() ); System.out.println( output ); CollectionType collectionType = CollectionType.listOf( ValueType.LONG ); - List list = stateSerialization.deserialize( module, collectionType, output ); + List list = serialization.deserialize( module, collectionType, output ); assertEquals( longCollection(), list ); } @@ -165,10 +165,10 @@ public class AbstractCollectionSerializationTest public void givenCollectionTypeWithFloatAndNullElementWhenSerializingAndDeserializingExpectEquals() throws Exception { - String output = stateSerialization.serialize( floatCollection() ); + String output = serialization.serialize( floatCollection() ); System.out.println( output ); CollectionType collectionType = CollectionType.listOf( ValueType.FLOAT ); - List list = stateSerialization.deserialize( module, collectionType, output ); + List list = serialization.deserialize( module, collectionType, output ); assertEquals( floatCollection(), list ); } @@ -176,10 +176,10 @@ public class AbstractCollectionSerializationTest public void givenCollectionTypeWithDoubleAndNullElementWhenSerializingExpectCorrectJsonOutput() throws Exception { - String output = stateSerialization.serialize( doubleCollection() ); + String output = serialization.serialize( doubleCollection() ); System.out.println( output ); CollectionType collectionType = CollectionType.listOf( ValueType.DOUBLE ); - List list = stateSerialization.deserialize( module, collectionType, output ); + List list = serialization.deserialize( module, collectionType, output ); assertEquals( doubleCollection(), list ); } @@ -187,10 +187,10 @@ public class AbstractCollectionSerializationTest public void givenCollectionTypeWithBigIntegerAndNullElementWhenSerializingAndDeserializingExpectEquals() throws Exception { - String output = stateSerialization.serialize( bigIntegerCollection() ); + String output = serialization.serialize( bigIntegerCollection() ); System.out.println( output ); CollectionType collectionType = CollectionType.listOf( ValueType.BIG_INTEGER ); - List list = stateSerialization.deserialize( module, collectionType, output ); + List list = serialization.deserialize( module, collectionType, output ); assertEquals( bigIntegerCollection(), list ); } @@ -198,10 +198,10 @@ public class AbstractCollectionSerializationTest public void givenCollectionTypeWithBigDecimalAndNullElementWhenSerializingAndDeserializingExpectEquals() throws Exception { - String output = stateSerialization.serialize( bigDecimalCollection() ); + String output = serialization.serialize( bigDecimalCollection() ); System.out.println( output ); CollectionType collectionType = CollectionType.collectionOf( ValueType.BIG_DECIMAL ); - Collection collection = stateSerialization.deserialize( module, collectionType, output ); + Collection collection = serialization.deserialize( module, collectionType, output ); assertEquals( bigDecimalCollection(), collection ); } @@ -209,10 +209,10 @@ public class AbstractCollectionSerializationTest public void givenMapOfStringByteAndNullElementWhenSerializingAndDeserializingExpectEquals() throws Exception { - String output = stateSerialization.serialize( stringByteMap() ); + String output = serialization.serialize( stringByteMap() ); System.out.println( output ); MapType mapType = MapType.of( ValueType.STRING, ValueType.BYTE ); - Map value = stateSerialization.deserialize( module, mapType, output ); + Map value = serialization.deserialize( module, mapType, output ); assertEquals( stringByteMap(), value ); } @@ -220,11 +220,11 @@ public class AbstractCollectionSerializationTest public void givenMapOfStringListStringAndNullElementWhenSerializingAndDeserializingExpectEquals() throws Exception { - String output = stateSerialization.serialize( stringMultiMap() ); + String output = serialization.serialize( stringMultiMap() ); System.out.println( output ); CollectionType collectionType = CollectionType.listOf( ValueType.STRING ); MapType mapType = MapType.of( ValueType.STRING, collectionType ); - Map> value = stateSerialization.deserialize( module, mapType, output ); + Map> value = serialization.deserialize( module, mapType, output ); assertEquals( stringMultiMap(), value ); } @@ -232,10 +232,10 @@ public class AbstractCollectionSerializationTest public void givenListOfMapStringStringAndNullElementWhenSerializingAndDeserializingExpectEquals() throws Exception { - String output = stateSerialization.serialize( stringListOfMaps() ); + String output = serialization.serialize( stringListOfMaps() ); System.out.println( output ); CollectionType collectionType = CollectionType.listOf( MapType.of( ValueType.STRING, ValueType.STRING ) ); - List> value = stateSerialization.deserialize( module, collectionType, output ); + List> value = serialization.deserialize( module, collectionType, output ); assertEquals( stringListOfMaps(), value ); } @@ -243,11 +243,11 @@ public class AbstractCollectionSerializationTest public void givenListOfValueCompositesAndNullElementWhenSerializingAndDeserializingExpectEquals() throws Exception { - String output = stateSerialization.serialize( valueCompositesList() ); + String output = serialization.serialize( valueCompositesList() ); System.out.println( output ); ValueCompositeType valueType = module.valueDescriptor( SomeValue.class.getName() ).valueType(); CollectionType collectionType = CollectionType.listOf( valueType ); - List value = stateSerialization.deserialize( module, collectionType, output ); + List value = serialization.deserialize( module, collectionType, output ); assertEquals( valueCompositesList(), value ); } @@ -255,10 +255,10 @@ public class AbstractCollectionSerializationTest public void givenEnumSetWhenSerializingAndDeserializingExpectEquals() { Set enumSet = EnumSet.allOf( SomeEnum.class ); - String output = stateSerialization.serialize( enumSet ); + String output = serialization.serialize( enumSet ); System.out.println( output ); CollectionType valueType = CollectionType.setOf( EnumType.of( SomeEnum.class ) ); - Set value = stateSerialization.deserialize( module, valueType, output ); + Set value = serialization.deserialize( module, valueType, output ); assertEquals( enumSet, value ); } @@ -270,10 +270,10 @@ public class AbstractCollectionSerializationTest { enumMap.put( value, 23 ); } - String output = stateSerialization.serialize( enumMap ); + String output = serialization.serialize( enumMap ); System.out.println( output ); MapType valueType = MapType.of( EnumType.of( SomeEnum.class ), ValueType.of( Integer.class ) ); - Map value = stateSerialization.deserialize( module, valueType, output ); + Map value = serialization.deserialize( module, valueType, output ); assertEquals( enumMap, value ); } http://git-wip-us.apache.org/repos/asf/polygene-java/blob/baba8c09/core/testsupport/src/main/java/org/apache/polygene/test/serialization/AbstractPlainValueSerializationTest.java ---------------------------------------------------------------------- diff --git a/core/testsupport/src/main/java/org/apache/polygene/test/serialization/AbstractPlainValueSerializationTest.java b/core/testsupport/src/main/java/org/apache/polygene/test/serialization/AbstractPlainValueSerializationTest.java index 8822a82..cd4bc37 100644 --- a/core/testsupport/src/main/java/org/apache/polygene/test/serialization/AbstractPlainValueSerializationTest.java +++ b/core/testsupport/src/main/java/org/apache/polygene/test/serialization/AbstractPlainValueSerializationTest.java @@ -50,7 +50,7 @@ import static org.hamcrest.core.IsNot.not; import static org.junit.Assert.assertThat; /** - * Assert that ValueSerialization behaviour on plain values is correct. + * Assert that Serialization behaviour on plain values is correct. * * Implementations must: *
    http://git-wip-us.apache.org/repos/asf/polygene-java/blob/baba8c09/core/testsupport/src/main/java/org/apache/polygene/test/serialization/AbstractValueCompositeSerializationTest.java ---------------------------------------------------------------------- diff --git a/core/testsupport/src/main/java/org/apache/polygene/test/serialization/AbstractValueCompositeSerializationTest.java b/core/testsupport/src/main/java/org/apache/polygene/test/serialization/AbstractValueCompositeSerializationTest.java index 2642198..221a788 100644 --- a/core/testsupport/src/main/java/org/apache/polygene/test/serialization/AbstractValueCompositeSerializationTest.java +++ b/core/testsupport/src/main/java/org/apache/polygene/test/serialization/AbstractValueCompositeSerializationTest.java @@ -67,7 +67,7 @@ import static org.hamcrest.CoreMatchers.is; import static org.junit.Assert.assertThat; /** - * Assert that ValueSerialization behaviour on ValueComposites is correct. + * Assert that Serialization behaviour on ValueComposites is correct. */ // TODO Assert Generics behaviour! public abstract class AbstractValueCompositeSerializationTest