svn commit: r804467 - /webservices/commons/trunk/modules/axiom/modules/axiom-api/src/main/java/org/apache/axiom/om/OMXMLStreamReader.java

[ve...@apache.org]

Author: veithen
Date: Sat Aug 15 12:37:09 2009
New Revision: 804467

URL: http://svn.apache.org/viewvc?rev=804467&view=rev
Log:
Deprecated the is/setInlineMTOM methods in OMXMLStreamReader. See Javadoc comments for details.

Modified:
    webservices/commons/trunk/modules/axiom/modules/axiom-api/src/main/java/org/apache/axiom/om/OMXMLStreamReader.java

Modified: webservices/commons/trunk/modules/axiom/modules/axiom-api/src/main/java/org/apache/axiom/om/OMXMLStreamReader.java
URL: http://svn.apache.org/viewvc/webservices/commons/trunk/modules/axiom/modules/axiom-api/src/main/java/org/apache/axiom/om/OMXMLStreamReader.java?rev=804467&r1=804466&r2=804467&view=diff
==============================================================================
--- webservices/commons/trunk/modules/axiom/modules/axiom-api/src/main/java/org/apache/axiom/om/OMXMLStreamReader.java (original)
+++ webservices/commons/trunk/modules/axiom/modules/axiom-api/src/main/java/org/apache/axiom/om/OMXMLStreamReader.java Sat Aug 15 12:37:09 2009
@@ -33,12 +33,20 @@
      * By default, an OMText item that has an MTOM datahandler 
      * will be rendered as a inlined text event.
      * @return true if inlined as TEXT, false if XOP_INCLUDE is used
+     * 
+     * @deprecated To return optimized base64 content as <tt>xop:Include</tt> elements, wrap the
+     *             reader using {@link org.apache.axiom.util.stax.xop.XOPEncodingStreamReader}.
+     *             This method introduces unnecessary complexity in the {@link XMLStreamReader}
+     *             implementation used by Axiom and will be removed in a future release.
      */
     public boolean isInlineMTOM();
     
     /**
      * @param value set to true if inlining of text is desired (default)
      * throw OMException if not the value is not supported.
+     * 
+     * @deprecated This method will be removed in a future release of Axiom. See
+     *             {@link #setInlineMTOM(boolean)} for more details.
      */
     public void setInlineMTOM(boolean value);