You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@ws.apache.org by ve...@apache.org on 2016/01/24 14:02:32 UTC

svn commit: r1726490 - in /webservices/axiom/branches/1.2.x: ./ implementations/axiom-impl/src/site/markdown/index.md.vm

Author: veithen
Date: Sun Jan 24 13:02:32 2016
New Revision: 1726490

URL: http://svn.apache.org/viewvc?rev=1726490&view=rev
Log:
Merge r1726489 to the 1.2 branch.

Modified:
    webservices/axiom/branches/1.2.x/   (props changed)
    webservices/axiom/branches/1.2.x/implementations/axiom-impl/src/site/markdown/index.md.vm

Propchange: webservices/axiom/branches/1.2.x/
------------------------------------------------------------------------------
--- svn:mergeinfo (original)
+++ svn:mergeinfo Sun Jan 24 13:02:32 2016
@@ -12,4 +12,4 @@
 /webservices/axiom/branches/attrs-aspects:1685218-1686663
 /webservices/axiom/branches/namespaceURIInterning:1293148-1293587
 /webservices/axiom/branches/osgi-redesign:1180368-1180596
-/webservices/axiom/trunk:1726096,1726101,1726474-1726475
+/webservices/axiom/trunk:1726096,1726101,1726474-1726475,1726489

Modified: webservices/axiom/branches/1.2.x/implementations/axiom-impl/src/site/markdown/index.md.vm
URL: http://svn.apache.org/viewvc/webservices/axiom/branches/1.2.x/implementations/axiom-impl/src/site/markdown/index.md.vm?rev=1726490&r1=1726489&r2=1726490&view=diff
==============================================================================
--- webservices/axiom/branches/1.2.x/implementations/axiom-impl/src/site/markdown/index.md.vm (original)
+++ webservices/axiom/branches/1.2.x/implementations/axiom-impl/src/site/markdown/index.md.vm Sun Jan 24 13:02:32 2016
@@ -22,4 +22,38 @@ About
 
 LLOM (Linked List Object Model) is the default implementation of the Axiom API.
 `OMAbstractFactory` and `OMXMLBuilderFactory` will use this implementation unless
-a different `OMMetaFactory` is selected explicitly.
\ No newline at end of file
+a different `OMMetaFactory` is selected explicitly.
+
+To use the LLOM implementation in your Maven project, add the following dependencies:
+
+    <dependency>
+        <groupId>org.apache.ws.commons.axiom</groupId>
+        <artifactId>axiom-api</artifactId>
+        <version>${release_version}</version>
+    </dependency>
+    <dependency>
+        <groupId>org.apache.ws.commons.axiom</groupId>
+        <artifactId>axiom-impl</artifactId>
+        <version>${release_version}</version>
+        <scope>runtime</scope>
+    </dependency>
+
+To use it in an OSGi environment, deploy the following minimum set of bundles:
+
+| Maven group ID                | Maven artifact ID    | Bundle symbolic name                     |
+| ----------------------------- | -------------------- | -----------------------------------------|
+| `org.apache.james`            | `apache-mime4j-core` | `org.apache.james.apache-mime4j-core`    |
+| `org.apache.ws.commons.axiom` | `axiom-api`          | `org.apache.ws.commons.axiom.axiom-api`  |
+| `org.apache.ws.commons.axiom` | `axiom-impl`         | `org.apache.ws.commons.axiom.axiom-impl` |
+
+This will use the StAX implementation in the JRE. If you want to use Woodstox instead, also
+deploy the following bundles:
+
+| Maven group ID                | Maven artifact ID                          | Bundle symbolic name                       |
+| ----------------------------- | ------------------------------------------ | -------------------------------------------|
+| `org.apache.servicemix.specs` | `org.apache.servicemix.specs.stax-api-1.0` | `org.apache.servicemix.specs.stax-api-1.0` |
+| `org.codehaus.woodstox`       | `stax2-api`                                | `stax2-api`                                |
+| `org.codehaus.woodstox`       | `woodstox-core-asl`                        | `woodstox-core-asl`                        |
+
+Note that the `geronimo-stax-api_1.0_spec` bundle doesn't work with Woodstox. See
+[here](http://veithen.github.io/2014/10/12/stax-osgi.html) for more information.