[felix-antora-site] 15/18: remove serialization framework doc (unmaintained)

[dj...@apache.org]

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 <dj...@apache.org>
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).