This is an automated email from the ASF dual-hosted git repository. djencks pushed a commit to branch main in repository https://gitbox.apache.org/repos/asf/felix-antora-site.git
commit 000b8367bd0af2f51367c2db2c4a6959c4efc66c Author: David Jencks <[email protected]> AuthorDate: Sun Jul 11 15:51:55 2021 -0700 remove serialization framework doc (unmaintained) --- modules/ROOT/pages/documentation/subprojects.adoc | 2 +- .../apache-felix-serialization-framework.adoc | 45 ---------------------- 2 files changed, 1 insertion(+), 46 deletions(-) diff --git a/modules/ROOT/pages/documentation/subprojects.adoc b/modules/ROOT/pages/documentation/subprojects.adoc index 7f192ca..b125e82 100644 --- a/modules/ROOT/pages/documentation/subprojects.adoc +++ b/modules/ROOT/pages/documentation/subprojects.adoc @@ -127,6 +127,6 @@ The last documentation may be found in the https://github.com/apache/felix-site- * https://github.com/apache/felix-site-pub/blob/last-cms/documentation/subprojects/mosgi-managed-osgi-framework.html[MOSGi Managed OSGi framework] * https://github.com/apache/felix-site-pub/blob/last-cms/documentation/subprojects/apache-felix-osgi-core.html[OSGi Core] * https://github.com/apache/felix-site-pub/blob/last-cms/documentation/subprojects/apache-felix-script-console-plugin.html[Script Console Plugin] -* xref:documentation/subprojects/apache-felix-serialization-framework.adoc[Serialization Framework] +* https://github.com/apache/felix-site-pub/blob/last-cms/documentation/subprojects/apache-felix-serialization-framework.html[Serialization Framework] * xref:documentation/subprojects/apache-felix-upnp.adoc[UPnP] * xref:documentation/subprojects/apache-felix-user-admin.adoc[User Admin] diff --git a/modules/ROOT/pages/documentation/subprojects/apache-felix-serialization-framework.adoc b/modules/ROOT/pages/documentation/subprojects/apache-felix-serialization-framework.adoc deleted file mode 100644 index f0a893f..0000000 --- a/modules/ROOT/pages/documentation/subprojects/apache-felix-serialization-framework.adoc +++ /dev/null @@ -1,45 +0,0 @@ -= Apache Felix Serialization Framework - -== Problem - -When you have an object graph that consists of objects that were created by different bundles, serializing and deserializing such a graph becomes a problem, since there is no single bundle that can "see" all (implementation) objects in the graph. - -The problem manifests itself for example in Apache Wicket, but also in other applications. -The serialization framework is a solution to this problem. - -== Design discussion sketch - -Made at ApacheCon EU 2009, Robert, Martijn, Felix and Marcel produced the following design on the flipover: - -[cols=2*] -|=== -| !sf_design.jpg -| thumbnail! -|=== - -== Service design - -Basically, we need two services: - -. The serialization service, that can serialize and deserialize an object graph to an output or input stream. -. Helpers that are used to (de)serialize specific objects. - -=== Serialization Service - - interface SerializationService { - void serialize(Object o, OutputStream s) throws IOException, UnknownObjectException; - Object deserialize(InputStream s) throws IOException, UnknownObjectException; - } - -The actual implementation of this service determines how objects are serialized. - -=== Serialization Helper - - interface SerializationHelper { - // TODO - } - -We also discussed adding a special manifest header to a bundle to create a sort of declarative serialization helper. -That way the bundle does not need to implement and register the service (if all of them use the same helper anyway). - -Helpers in some way need to be linked to a specific serialization service (using an XML serialization with a JSON helper will probably not be what you want).
