abc;
+ * }
*
* In this case this method returns a list of two {@link TypeRef}s.
*
@@ -107,7 +107,7 @@
* If {@link #isCollection()}==false, this property is always false.
*
*
- * When this flag is true, getTypes().size()==1 always holds.
+ * When this flag is true, {@code getTypes().size()==1} always holds.
*/
boolean isValueList();
--- old/src/java.xml.bind/share/classes/com/sun/xml/internal/bind/v2/model/core/MapPropertyInfo.java 2015-09-19 13:15:13.352684749 +0300
+++ new/src/java.xml.bind/share/classes/com/sun/xml/internal/bind/v2/model/core/MapPropertyInfo.java 2015-09-19 13:15:13.224684115 +0300
@@ -32,7 +32,7 @@
/**
* Property that maps to the following schema fragment.
*
- *
<![CDATA[
+ * <pre>{@code
* <xs:complexType>
* <xs:sequence>
* <xs:element name="entry" minOccurs="0" maxOccurs="unbounded">
@@ -45,7 +45,7 @@
* </xs:element>
* </xs:sequence>
* </xs:complexType>
- * ]]>
* This property is used to represent a default binding of a {@link Map} property.
--- old/src/java.xml.bind/share/classes/com/sun/xml/internal/bind/v2/model/core/TypeInfoSet.java 2015-09-19 13:15:13.844687189 +0300
+++ new/src/java.xml.bind/share/classes/com/sun/xml/internal/bind/v2/model/core/TypeInfoSet.java 2015-09-19 13:15:13.712686534 +0300
@@ -153,7 +153,7 @@
* A map from namespace URI to the value of the location.
* If the entry is missing, that means a schema should be generated for that namespace.
* If the value is "", that means the schema location is implied
- * (<xs:schema namespace="..."/> w/o schemaLocation.)
+ * ({@code getSchemaLocations();
--- old/src/java.xml.bind/share/classes/com/sun/xml/internal/bind/v2/model/impl/AnyTypeImpl.java 2015-09-19 13:15:14.344689668 +0300
+++ new/src/java.xml.bind/share/classes/com/sun/xml/internal/bind/v2/model/impl/AnyTypeImpl.java 2015-09-19 13:15:14.200688954 +0300
@@ -35,7 +35,7 @@
import com.sun.xml.internal.bind.v2.model.annotation.Locatable;
/**
- * {@link TypeInfo} implementation for xs:anyType .
+ * {@link TypeInfo} implementation for {@code xs:anyType}.
*
* @author Kohsuke Kawaguchi
*/
--- old/src/java.xml.bind/share/classes/com/sun/xml/internal/bind/v2/model/impl/TypeInfoSetImpl.java 2015-09-19 13:15:14.840692128 +0300
+++ new/src/java.xml.bind/share/classes/com/sun/xml/internal/bind/v2/model/impl/TypeInfoSetImpl.java 2015-09-19 13:15:14.696691414 +0300
@@ -119,7 +119,7 @@
};
/**
- * {@link TypeInfo} for xs:anyType .
+ * {@link TypeInfo} for {@code xs:anyType}.
*
* anyType is the only {@link TypeInfo} that works with an interface,
* and accordingly it requires a lot of special casing.
--- old/src/java.xml.bind/share/classes/com/sun/xml/internal/bind/v2/model/nav/GenericArrayTypeImpl.java 2015-09-19 13:15:15.352694667 +0300
+++ new/src/java.xml.bind/share/classes/com/sun/xml/internal/bind/v2/model/nav/GenericArrayTypeImpl.java 2015-09-19 13:15:15.204693933 +0300
@@ -40,10 +40,10 @@
}
/**
- * Returns a Type object representing the component type
+ * Returns a {@code Type} object representing the component type
* of this array.
*
- * @return a Type object representing the component type
+ * @return a {@code Type} object representing the component type
* of this array
* @since 1.5
*/
--- old/src/java.xml.bind/share/classes/com/sun/xml/internal/bind/v2/model/nav/Navigator.java 2015-09-19 13:15:15.852697146 +0300
+++ new/src/java.xml.bind/share/classes/com/sun/xml/internal/bind/v2/model/nav/Navigator.java 2015-09-19 13:15:15.708696432 +0300
@@ -70,17 +70,17 @@
*
*
* For example, given the following
- *
<![CDATA[
+ * <pre>{@code
* interface Foo<T> extends List<List<T>> {}
* interface Bar extends Foo<String> {}
- * ]]> <![CDATA[
- * getBaseClass( Bar, List ) = List<List<String>
+ * <pre>{@code
+ * getBaseClass( Bar, List ) = List<List<String>>
* getBaseClass( Bar, Foo ) = Foo<String>
* getBaseClass( Foo<? extends Number>, Collection ) = Collection<List<? extends Number>>
* getBaseClass( ArrayList<? extends BigInteger>, List ) = List<? extends BigInteger>
- * ]]> }.
*/
public Type createParameterizedType(Class rawType, Type... arguments) {
return new ParameterizedTypeImpl(rawType, arguments, null);
--- old/src/java.xml.bind/share/classes/com/sun/xml/internal/bind/v2/model/runtime/RuntimeArrayInfo.java 2015-09-19 13:15:16.864702164 +0300
+++ new/src/java.xml.bind/share/classes/com/sun/xml/internal/bind/v2/model/runtime/RuntimeArrayInfo.java 2015-09-19 13:15:16.712701411 +0300
@@ -35,7 +35,7 @@
*/
public interface RuntimeArrayInfo extends ArrayInfo, RuntimeNonElement {
/**
- * Represents T[] .
+ * Represents {@code T[]}.
*
* The same as {@link TypeInfo#getType()} but at the runtime, an array
* is guaranteed to have a {@link Class} representation, not just any {@link Type}.
--- old/src/java.xml.bind/share/classes/com/sun/xml/internal/bind/v2/runtime/AnyTypeBeanInfo.java 2015-09-19 13:15:17.356704604 +0300
+++ new/src/java.xml.bind/share/classes/com/sun/xml/internal/bind/v2/runtime/AnyTypeBeanInfo.java 2015-09-19 13:15:17.224703950 +0300
@@ -48,7 +48,7 @@
import org.xml.sax.SAXException;
/**
- * {@link JaxBeanInfo} for handling xs:anyType .
+ * {@link JaxBeanInfo} for handling {@code xs:anyType}.
*
* @author Kohsuke Kawaguchi
*/
--- old/src/java.xml.bind/share/classes/com/sun/xml/internal/bind/v2/runtime/IllegalAnnotationException.java 2015-09-19 13:15:17.856707083 +0300
+++ new/src/java.xml.bind/share/classes/com/sun/xml/internal/bind/v2/runtime/IllegalAnnotationException.java 2015-09-19 13:15:17.712706369 +0300
@@ -119,7 +119,7 @@
* annotation, in which case this method returns a list that
* contains another list, which in turn contains the location
* information that leads to the error location
- * (IOW, [ [pos1,pos2,...,posN] ] )
+ * (IOW, {@code [ [pos1,pos2,...,posN] ]})
*
*
* Sometimes, an error could occur because of two or more conflicting
@@ -127,12 +127,12 @@
* that contains many lists, where each list contains
* the location information that leads to each of the conflicting
* annotations
- * (IOW, [ [pos11,pos12,...,pos1N],[pos21,pos22,...,pos2M], ... ] )
+ * (IOW, {@code [ [pos11,pos12,...,pos1N],[pos21,pos22,...,pos2M], ... ]})
*
*
* Yet some other time, the runtime can fail to provide any
* error location, in which case this method returns an empty list.
- * (IOW, [] ). We do try hard to make sure this won't happen,
+ * (IOW, {@code []}). We do try hard to make sure this won't happen,
* so please let us know
* if you see this behavior.
*
@@ -146,13 +146,13 @@
* to the first in the list, sort of like a stack trace.
*
*
- * For example, suppose you specify class Foo to {@link JAXBContext},
- * Foo derives from Bar , Bar has a field pea
- * that points to Zot , Zot contains a gum
+ * For example, suppose you specify class {@code Foo} to {@link JAXBContext},
+ * {@code Foo} derives from {@code Bar}, {@code Bar} has a field {@code pea}
+ * that points to {@code Zot}, {@code Zot} contains a {@code gum}
* property, and this property has an errornous annotation.
* Then when this exception is thrown, the list of {@link Location}s
* will look something like
- * [ "gum property", "Zot class", "pea property", "Bar class", "Foo class" ]
+ * {@code [ "gum property", "Zot class", "pea property", "Bar class", "Foo class" ]}
*
*
* @return
--- old/src/java.xml.bind/share/classes/com/sun/xml/internal/bind/v2/runtime/JAXBContextImpl.java 2015-09-19 13:15:18.356709563 +0300
+++ new/src/java.xml.bind/share/classes/com/sun/xml/internal/bind/v2/runtime/JAXBContextImpl.java 2015-09-19 13:15:18.216708869 +0300
@@ -533,7 +533,7 @@
* This method traverses the base classes of the given object.
*
* @return null
- * if c isn't a JAXB-bound class and fatal==false .
+ * if {@code c} isn't a JAXB-bound class and {@code fatal==false}.
*/
public final JaxBeanInfo getBeanInfo(Object o) {
// don't allow xs:anyType beanInfo to handle all the unbound objects
@@ -577,7 +577,7 @@
* This method doesn't look for base classes.
*
* @return null
- * if c isn't a JAXB-bound class and fatal==false .
+ * if {@code c} isn't a JAXB-bound class and {@code fatal==false}.
*/
public final JaxBeanInfo getBeanInfo(Class clazz) {
return (JaxBeanInfo)beanInfoMap.get(clazz);
--- old/src/java.xml.bind/share/classes/com/sun/xml/internal/bind/v2/runtime/JaxBeanInfo.java 2015-09-19 13:15:18.868712102 +0300
+++ new/src/java.xml.bind/share/classes/com/sun/xml/internal/bind/v2/runtime/JaxBeanInfo.java 2015-09-19 13:15:18.728711408 +0300
@@ -68,7 +68,7 @@
*
* Typically, {@link JaxBeanInfo} implementations should be generated
* by XJC/JXC. Those impl classes will register themselves to their
- * master ObjectFactory class.
+ * master {@code ObjectFactory} class.
*
*
* The type parameter BeanT is the Java class of the bean that this represents.
--- old/src/java.xml.bind/share/classes/com/sun/xml/internal/bind/v2/runtime/XMLSerializer.java 2015-09-19 13:15:19.372714601 +0300
+++ new/src/java.xml.bind/share/classes/com/sun/xml/internal/bind/v2/runtime/XMLSerializer.java 2015-09-19 13:15:19.232713907 +0300
@@ -378,7 +378,7 @@
* c.endElement();
*
*
- * will generate <foo>abc def<bar/>ghi</foo>.
+ * will generate {@code abc def }.
*/
public void text( String text, String fieldName ) throws SAXException, IOException, XMLStreamException {
// If the assertion fails, it must be a bug of xjc.
@@ -492,7 +492,7 @@
* When a cycle is found, this method tries to recover from it.
*
* @return
- * the object that should be marshalled instead of the given obj ,
+ * the object that should be marshalled instead of the given {@code obj},
* or null if the error is found and we need to avoid marshalling this object
* to prevent infinite recursion. When this method returns null, the error
* has already been reported.
--- old/src/java.xml.bind/share/classes/com/sun/xml/internal/bind/v2/runtime/property/SingleMapNodeProperty.java 2015-09-19 13:15:19.888717160 +0300
+++ new/src/java.xml.bind/share/classes/com/sun/xml/internal/bind/v2/runtime/property/SingleMapNodeProperty.java 2015-09-19 13:15:19.744716446 +0300
@@ -134,7 +134,7 @@
private Loader valueLoader;
/**
- * Handles <items> and </items>.
+ * Handles {@code } and {@code }.
*
* The target will be set to a {@link Map}.
*/
@@ -190,7 +190,7 @@
};
/**
- * Handles <entry> and </entry>.
+ * Handles {@code } and {@code }.
*
* The target will be set to a {@link Map}.
*/
--- old/src/java.xml.bind/share/classes/com/sun/xml/internal/bind/v2/runtime/reflect/Accessor.java 2015-09-19 13:15:20.392719659 +0300
+++ new/src/java.xml.bind/share/classes/com/sun/xml/internal/bind/v2/runtime/reflect/Accessor.java 2015-09-19 13:15:20.252718965 +0300
@@ -87,7 +87,7 @@
*
* @param context The {@link JAXBContextImpl} that owns the whole thing.
* (See {@link RuntimeModelBuilder#context}.)
- * @return At least the implementation can return this .
+ * @return At least the implementation can return {@code this}.
*/
public Accessor optimize(@Nullable JAXBContextImpl context) {
return this;
--- old/src/java.xml.bind/share/classes/com/sun/xml/internal/bind/v2/runtime/unmarshaller/Loader.java 2015-09-19 13:15:20.912722237 +0300
+++ new/src/java.xml.bind/share/classes/com/sun/xml/internal/bind/v2/runtime/unmarshaller/Loader.java 2015-09-19 13:15:20.752721444 +0300
@@ -64,7 +64,7 @@
* and when the parent designated this loader as the child loader.
*
*
- * The callee may change state.loader to designate another {@link Loader}
+ * The callee may change {@code state.loader} to designate another {@link Loader}
* for the processing. It's the responsibility of the callee to forward the startElement
* event in such a case.
*
--- old/src/java.xml.bind/share/classes/com/sun/xml/internal/bind/v2/runtime/unmarshaller/MTOMDecorator.java 2015-09-19 13:15:21.412724717 +0300
+++ new/src/java.xml.bind/share/classes/com/sun/xml/internal/bind/v2/runtime/unmarshaller/MTOMDecorator.java 2015-09-19 13:15:21.272724023 +0300
@@ -58,9 +58,9 @@
* UGLY HACK: we need to ignore the whitespace that follows
* the attached base64 image.
*
- * This happens twice; once before </xop:Include>, another
- * after </xop:Include>. The spec guarantees that
- * no valid pcdata can follow </xop:Include>.
+ * This happens twice; once before {@code }, another
+ * after {@code }. The spec guarantees that
+ * no valid pcdata can follow {@code }.
*/
private boolean followXop;
--- old/src/java.xml.bind/share/classes/com/sun/xml/internal/bind/v2/runtime/unmarshaller/UnmarshallingContext.java 2015-09-19 13:15:21.904727157 +0300
+++ new/src/java.xml.bind/share/classes/com/sun/xml/internal/bind/v2/runtime/unmarshaller/UnmarshallingContext.java 2015-09-19 13:15:21.768726482 +0300
@@ -150,9 +150,9 @@
*
*
* This flag is unused when {@link #assoc}==null.
- * If it's non-null, then true indicates
+ * If it's non-null, then {@code true} indicates
* that we are doing in-place associative unmarshalling.
- * If false , then we are doing associative unmarshalling
+ * If {@code false}, then we are doing associative unmarshalling
* without object reuse.
*/
private boolean isInplaceMode;
--- old/src/java.xml.bind/share/classes/com/sun/xml/internal/bind/v2/schemagen/Form.java 2015-09-19 13:15:22.428729755 +0300
+++ new/src/java.xml.bind/share/classes/com/sun/xml/internal/bind/v2/schemagen/Form.java 2015-09-19 13:15:22.284729041 +0300
@@ -72,7 +72,7 @@
}
/**
- * Writes the attribute on the generated <schema> element.
+ * Writes the attribute on the generated {@code } element.
*/
abstract void declare(String attName, Schema schema);
--- old/src/java.xml.bind/share/classes/com/sun/xml/internal/bind/v2/schemagen/XmlSchemaGenerator.java 2015-09-19 13:15:22.920732195 +0300
+++ new/src/java.xml.bind/share/classes/com/sun/xml/internal/bind/v2/schemagen/XmlSchemaGenerator.java 2015-09-19 13:15:22.780731500 +0300
@@ -551,7 +551,7 @@
/**
* Process the given PropertyInfo looking for references to namespaces that
* are foreign to the given namespace. Any foreign namespace references
- * found are added to the given namespaces dependency list and an <import>
+ * found are added to the given namespaces dependency list and an {@code }
* is generated for it.
*
* @param p the PropertyInfo
@@ -1140,7 +1140,8 @@
/**
* Checks if we can collapse
- * <element name='foo' type='t' /> to <element ref='foo' />.
+ * {@code null if the map contains no mapping for this key.
+ * or {@code null} if the map contains no mapping for this key.
*
* @param nsUri the namespaceUri key whose associated value is to be returned.
* @param localPart the localPart key whose associated value is to be returned.
* @return the value to which this map maps the specified set of keya, or
- * null if the map contains no mapping for this set of keys.
+ * {@code null} if the map contains no mapping for this set of keys.
* @see #put(String,String, Object)
*/
public V get( String nsUri, String localPart ) {
--- old/src/java.xml.bind/share/classes/com/sun/xml/internal/org/jvnet/mimepull/MIMEParsingException.java 2015-09-19 13:15:23.956737332 +0300
+++ new/src/java.xml.bind/share/classes/com/sun/xml/internal/org/jvnet/mimepull/MIMEParsingException.java 2015-09-19 13:15:23.808736598 +0300
@@ -71,13 +71,14 @@
/**
* Constructs a new WebServiceException with the specified cause
- * and a detail message of (cause==null ? null :
- * cause.toString()) (which typically contains the
- * class and detail message of cause ).
+ * and a detail message of
+ * {@code (cause==null ? null : cause.toString())}
+ * (which typically contains the
+ * class and detail message of {@code cause}).
*
* @param cause The cause which is saved for the later
* retrieval throw by the getCause method.
- * (A null value is permitted, and
+ * (A {@code null} value is permitted, and
* indicates that the cause is nonexistent or
* unknown.)
*/
--- old/src/java.xml.bind/share/classes/com/sun/xml/internal/org/jvnet/staxex/NamespaceContextEx.java 2015-09-19 13:15:24.448739772 +0300
+++ new/src/java.xml.bind/share/classes/com/sun/xml/internal/org/jvnet/staxex/NamespaceContextEx.java 2015-09-19 13:15:24.312739097 +0300
@@ -42,19 +42,19 @@
*
* This method enumerates all the active in-scope namespace bindings.
* This does not include implicit bindings, such as
- * "xml"->"http://www.w3.org/XML/1998/namespace"
- * or ""->"" (the implicit default namespace URI.)
+ * {@code "xml"->"http://www.w3.org/XML/1998/namespace"}
+ * or {@code ""->""} (the implicit default namespace URI.)
*
*
* The returned iterator may not include the same prefix more than once.
- * For example, the returned iterator may only contain f=ns2
+ * For example, the returned iterator may only contain {@code f=ns2}
* if the document is as follows and this method is used at the bar element.
*
- *
<![CDATA[
+ * <pre>{@code
* <foo xmlns:f='ns1'>
* <bar xmlns:f='ns2'>
* ...
- * ]]>
* The iteration may be done in no particular order.
--- old/src/java.xml.bind/share/classes/com/sun/xml/internal/org/jvnet/staxex/XMLStreamReaderEx.java 2015-09-19 13:15:24.936742191 +0300
+++ new/src/java.xml.bind/share/classes/com/sun/xml/internal/org/jvnet/staxex/XMLStreamReaderEx.java 2015-09-19 13:15:24.796741497 +0300
@@ -111,7 +111,7 @@
// * if the parser is not pointing at characters infoset item.
// * @throws XMLStreamException
// * if the parser points to text but text is not base64-encoded text,
- // * or if some other parsing error occurs (such as if the <xop:Include>
+ // * or if some other parsing error occurs (such as if the {@code }
// * points to a non-existing attachment.)
// *
// *
--- old/src/java.xml.bind/share/classes/com/sun/xml/internal/txw2/Document.java 2015-09-19 13:15:25.436744671 +0300
+++ new/src/java.xml.bind/share/classes/com/sun/xml/internal/txw2/Document.java 2015-09-19 13:15:25.296743977 +0300
@@ -286,7 +286,7 @@
* by using {@link #activeNamespaces}.
*
* @return
- * the buffer passed as the buf parameter.
+ * the buffer passed as the {@code buf} parameter.
*/
private StringBuilder fixPrefix(StringBuilder buf) {
assert activeNamespaces!=null;
--- old/src/java.xml.bind/share/classes/com/sun/xml/internal/txw2/TypedXmlWriter.java 2015-09-19 13:15:25.928747111 +0300
+++ new/src/java.xml.bind/share/classes/com/sun/xml/internal/txw2/TypedXmlWriter.java 2015-09-19 13:15:25.792746436 +0300
@@ -45,7 +45,7 @@
* Commits this element (and all its descendants) to the output.
*
*
- * Short for _commit(true) .
+ * Short for {@code _commit(true)}.
*/
void commit();
--- old/src/java.xml.bind/share/classes/com/sun/xml/internal/txw2/annotation/XmlAttribute.java 2015-09-19 13:15:26.440749649 +0300
+++ new/src/java.xml.bind/share/classes/com/sun/xml/internal/txw2/annotation/XmlAttribute.java 2015-09-19 13:15:26.288748896 +0300
@@ -37,12 +37,12 @@
* Specifies that the invocation of the method will produce an attribute.
*
*
- * The method signature has to match the form R foo(DT1,DT2,..)
+ * The method signature has to match the form {@code R foo(DT1,DT2,..)}
*
*
- * R is either void or the type to which the interface that declares
+ * R is either {@code void} or the type to which the interface that declares
* this method is assignable. In the case of the latter, the method will return
- * this object, allowing you to chain the multiple attribute method
+ * {@code this} object, allowing you to chain the multiple attribute method
* invocations like {@link StringBuffer}.
*
*
--- old/src/java.xml.bind/share/classes/com/sun/xml/internal/txw2/annotation/XmlElement.java 2015-09-19 13:15:26.952752188 +0300
+++ new/src/java.xml.bind/share/classes/com/sun/xml/internal/txw2/annotation/XmlElement.java 2015-09-19 13:15:26.788751375 +0300
@@ -50,13 +50,13 @@
* The method signature has to match one of the following patterns.
*
*
- * Child writer: TW foo()
+ * Child writer: {@code TW foo()}
* TW must be an interface derived from {@link TypedXmlWriter}.
* When this method is called, a new child element is started,
- * and its content can be written by using the returned TW
+ * and its content can be written by using the returned {@code TW}
* object. This child element will be ended when its _commit method
* is called.
- * Leaf element: void foo(DT1,DT2,...)
+ * Leaf element: {@code void foo(DT1,DT2,...)}
* DTi must be datatype objects.
* When this method is called, a new child element is started,
* followed by the whitespace-separated text data from each of
--- old/src/java.xml.bind/share/classes/com/sun/xml/internal/txw2/annotation/XmlValue.java 2015-09-19 13:15:27.452754668 +0300
+++ new/src/java.xml.bind/share/classes/com/sun/xml/internal/txw2/annotation/XmlValue.java 2015-09-19 13:15:27.308753954 +0300
@@ -34,12 +34,12 @@
* Specifies that the invocation of the method will produce a text
*
*
- * The method signature has to match the form R foo(DT1,DT2,..)
+ * The method signature has to match the form {@code R foo(DT1,DT2,..)}
*
*
- * R is either void or the type to which the interface that declares
+ * R is either {@code void} or the type to which the interface that declares
* this method is assignable. In the case of the latter, the method will return
- * this object, allowing you to chain the multiple method
+ * {@code this} object, allowing you to chain the multiple method
* invocations like {@link StringBuffer}.
*
*
--- old/src/java.xml.bind/share/classes/com/sun/xml/internal/txw2/output/DataWriter.java 2015-09-19 13:15:27.952757147 +0300
+++ new/src/java.xml.bind/share/classes/com/sun/xml/internal/txw2/output/DataWriter.java 2015-09-19 13:15:27.808756433 +0300
@@ -77,15 +77,15 @@
*
*
This code will produce the following document:
*
- *
- * <?xml version="1.0" standalone="yes"?>
+ * {@code
+ *
*
- * <Person>
- * <name>Jane Smith</name>
- * <date-of-birth>1965-05-23</date-of-birth>
- * <citizenship>US</citizenship>
- * </Person>
- *
+ *
+ * Jane Smith
+ * 1965-05-23
+ * US
+ *
+ * }
*
* This class inherits from {@link XMLWriter},
* and provides all of the same support for Namespaces.
--- old/src/java.xml.bind/share/classes/com/sun/xml/internal/txw2/output/XMLWriter.java 2015-09-19 13:15:28.456759646 +0300
+++ new/src/java.xml.bind/share/classes/com/sun/xml/internal/txw2/output/XMLWriter.java 2015-09-19 13:15:28.316758952 +0300
@@ -93,11 +93,11 @@
*
* The resulting document will look like this:
*
- *
- * <?xml version="1.0" standalone="yes"?>
+ * {@code
+ *
*
- * <greeting>Hello, world!</greeting>
- *
+ * Hello, world!
+ * }
*
* In fact, there is an even simpler convenience method,
* dataElement , designed for writing elements that
@@ -127,9 +127,9 @@
*
*
you will end up with
*
- *
- * <item>1</item><item>3</item><item>3</item>
- *
+ * {@code
+ * - 1
- 3
- 3
+ * }
*
* You need to invoke one of the characters methods
* explicitly to add newlines or indentation. Alternatively, you
@@ -156,11 +156,11 @@
*
*
The resulting document will look like this:
*
- *
- * <?xml version="1.0" standalone="yes"?>
+ * {@code
+ *
*
- * <_NS1:foo xmlns:_NS1="http://www.foo.com/ns/"/>
- *
+ * <_NS1:foo xmlns:_NS1="http://www.foo.com/ns/"/>
+ * }
*
* In many cases, document authors will prefer to choose their
* own prefixes rather than using the (ugly) default names. The
@@ -188,11 +188,11 @@
*
*
The resulting document will look like this:
*
- *
- * <?xml version="1.0" standalone="yes"?>
+ * {@code
+ *
*
- * <foo:foo xmlns:foo="http://www.foo.com/ns/"/>
- *
+ *
*
* The default Namespace simply uses an empty string as the prefix:
*
@@ -205,28 +205,28 @@
*
* The resulting document will look like this:
*
- *
- * <?xml version="1.0" standalone="yes"?>
+ * {@code
+ *
*
- * <foo xmlns="http://www.foo.com/ns/"/>
- *
+ *
*
* By default, the XML writer will not declare a Namespace until
* it is actually used. Sometimes, this approach will create
* a large number of Namespace declarations, as in the following
* example:
*
- *
- * <xml version="1.0" standalone="yes"?>
+ * {@code
+ *
*
- * <rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#">
- * <rdf:Description about="http://www.foo.com/ids/books/12345">
- * <dc:title xmlns:dc="http://www.purl.org/dc/">A Dark Night</dc:title>
- * <dc:creator xmlns:dc="http://www.purl.org/dc/">Jane Smith</dc:title>
- * <dc:date xmlns:dc="http://www.purl.org/dc/">2000-09-09</dc:title>
- * </rdf:Description>
- * </rdf:RDF>
- *
+ *
+ *
+ * A Dark Night
+ * Jane Smith
+ * 2000-09-09
+ *
+ *
+ * }
*
* The "rdf" prefix is declared only once, because the RDF Namespace
* is used by the root element and can be inherited by all of its
@@ -243,18 +243,18 @@
* though it's not needed there, and can be inherited by its
* descendants:
*
- *
- * <xml version="1.0" standalone="yes"?>
+ * {@code
+ *
*
- * <rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
+ *
- * <rdf:Description about="http://www.foo.com/ids/books/12345">
- * <dc:title>A Dark Night</dc:title>
- * <dc:creator>Jane Smith</dc:title>
- * <dc:date>2000-09-09</dc:title>
- * </rdf:Description>
- * </rdf:RDF>
- *
+ *
+ * A Dark Night
+ * Jane Smith
+ * 2000-09-09
+ *
+ *
+ * }
*
* This approach is also useful for declaring Namespace prefixes
* that be used by qualified names appearing in attribute values or
@@ -388,7 +388,7 @@
/**
* Set whether the writer should print out the XML declaration
- * (<?xml version='1.0' ... ?>).
+ * ({@code }).
*
* This option is set to true by default.
*/
--- old/src/java.xml.bind/share/classes/javax/xml/bind/Binder.java 2015-09-19 13:15:28.968762185 +0300
+++ new/src/java.xml.bind/share/classes/javax/xml/bind/Binder.java 2015-09-19 13:15:28.828761491 +0300
@@ -95,10 +95,10 @@
*
* This method throws {@link UnmarshalException} when the Binder's
* {@link JAXBContext} does not have a mapping for the XML element name
- * or the type, specifiable via @xsi:type , of xmlNode
+ * or the type, specifiable via {@code @xsi:type}, of {@code xmlNode}
* to a JAXB mapped class. The method {@link #unmarshal(Object, Class)}
* enables an application to specify the JAXB mapped class that
- * the xmlNode should be mapped to.
+ * the {@code xmlNode} should be mapped to.
*
* @param xmlNode
* the document/element to unmarshal XML data from.
@@ -110,8 +110,8 @@
* If any unexpected errors occur while unmarshalling
* @throws UnmarshalException
* If the {@link ValidationEventHandler ValidationEventHandler}
- * returns false from its handleEvent method or the
- * Binder is unable to perform the XML to Java
+ * returns false from its {@code handleEvent} method or the
+ * {@code Binder} is unable to perform the XML to Java
* binding.
* @throws IllegalArgumentException
* If the node parameter is null
@@ -119,7 +119,7 @@
public abstract Object unmarshal( XmlNode xmlNode ) throws JAXBException;
/**
- * Unmarshal XML root element by provided declaredType
+ * Unmarshal XML root element by provided {@code declaredType}
* to a JAXB object tree.
*
*
@@ -138,18 +138,18 @@
* @param xmlNode
* the document/element to unmarshal XML data from.
* @param declaredType
- * appropriate JAXB mapped class to hold node 's XML data.
+ * appropriate JAXB mapped class to hold {@code node}'s XML data.
*
* @return
* JAXB Element representation
- * of node
+ * of {@code node}
*
* @throws JAXBException
* If any unexpected errors occur while unmarshalling
* @throws UnmarshalException
* If the {@link ValidationEventHandler ValidationEventHandler}
- * returns false from its handleEvent method or the
- * Binder is unable to perform the XML to Java
+ * returns false from its {@code handleEvent} method or the
+ * {@code Binder} is unable to perform the XML to Java
* binding.
* @throws IllegalArgumentException
* If any of the input parameters are null
@@ -182,9 +182,9 @@
* If any unexpected problem occurs during the marshalling.
* @throws MarshalException
* If the {@link ValidationEventHandler ValidationEventHandler}
- * returns false from its handleEvent method or the
- * Binder is unable to marshal jaxbObject (or any
- * object reachable from jaxbObject ).
+ * returns false from its {@code handleEvent} method or the
+ * {@code Binder} is unable to marshal {@code jaxbObject} (or any
+ * object reachable from {@code jaxbObject}).
*
* @throws IllegalArgumentException
* If any of the method parameters are null
@@ -343,9 +343,9 @@
public abstract Schema getSchema();
/**
- * Allow an application to register a ValidationEventHandler .
+ * Allow an application to register a {@code ValidationEventHandler}.
*
- * The ValidationEventHandler will be called by the JAXB Provider
+ * The {@code ValidationEventHandler} will be called by the JAXB Provider
* if any validation errors are encountered during calls to any of the
* Binder unmarshal, marshal and update methods.
*
@@ -373,7 +373,7 @@
/**
*
* Set the particular property in the underlying implementation of
- * Binder . This method can only be used to set one of
+ * {@code Binder}. This method can only be used to set one of
* the standard JAXB defined unmarshal/marshal properties
* or a provider specific property for binder, unmarshal or marshal.
* Attempting to set an undefined property will result in
@@ -397,7 +397,7 @@
/**
* Get the particular property in the underlying implementation of
- * Binder . This method can only
+ * {@code Binder}. This method can only
* be used to get one of
* the standard JAXB defined unmarshal/marshal properties
* or a provider specific property for binder, unmarshal or marshal.
--- old/src/java.xml.bind/share/classes/javax/xml/bind/DataBindingException.java 2015-09-19 13:15:29.468764665 +0300
+++ new/src/java.xml.bind/share/classes/javax/xml/bind/DataBindingException.java 2015-09-19 13:15:29.332763990 +0300
@@ -30,7 +30,7 @@
*
*
* This exception differs from {@link JAXBException} in that
- * this is an unchecked exception, while JAXBException
+ * this is an unchecked exception, while {@code JAXBException}
* is a checked exception.
*
* @see JAXB
--- old/src/java.xml.bind/share/classes/javax/xml/bind/DatatypeConverter.java 2015-09-19 13:15:29.956767084 +0300
+++ new/src/java.xml.bind/share/classes/javax/xml/bind/DatatypeConverter.java 2015-09-19 13:15:29.820766410 +0300
@@ -294,7 +294,7 @@
* Converts the string argument into a byte value.
*
*
- * String parameter lexicalXSDQname must conform to lexical value space specifed at
+ * String parameter {@code lexicalXSDQname} must conform to lexical value space specifed at
* XML Schema Part 2:Datatypes specification:QNames
*
* @param lexicalXSDQName
@@ -304,7 +304,7 @@
* @return
* A QName value represented by the string argument.
* @throws IllegalArgumentException if string parameter does not conform to XML Schema Part 2 specification or
- * if namespace prefix of lexicalXSDQname is not bound to a URI in NamespaceContext nsc .
+ * if namespace prefix of {@code lexicalXSDQname} is not bound to a URI in NamespaceContext {@code nsc}.
*/
public static javax.xml.namespace.QName parseQName( String lexicalXSDQName,
NamespaceContext nsc) {
@@ -365,7 +365,7 @@
* of xsd:unsignedInt.
* @return
* A long value represented by the string argument.
- * @throws NumberFormatException if string parameter can not be parsed into a long value.
+ * @throws NumberFormatException if string parameter can not be parsed into a {@code long} value.
*/
public static long parseUnsignedInt( String lexicalXSDUnsignedInt ) {
if (theConverter == null) initConverter();
@@ -380,7 +380,7 @@
* representation of xsd:unsignedShort.
* @return
* An int value represented by the string argument.
- * @throws NumberFormatException if string parameter can not be parsed into an int value.
+ * @throws NumberFormatException if string parameter can not be parsed into an {@code int} value.
*/
public static int parseUnsignedShort( String lexicalXSDUnsignedShort ) {
if (theConverter == null) initConverter();
@@ -454,7 +454,7 @@
* A BigInteger value
* @return
* A string containing a lexical representation of xsd:integer
- * @throws IllegalArgumentException val is null.
+ * @throws IllegalArgumentException {@code val} is null.
*/
public static String printInteger( java.math.BigInteger val ) {
if (theConverter == null) initConverter();
@@ -507,7 +507,7 @@
* A BigDecimal value
* @return
* A string containing a lexical representation of xsd:decimal
- * @throws IllegalArgumentException val is null.
+ * @throws IllegalArgumentException {@code val} is null.
*/
public static String printDecimal( java.math.BigDecimal val ) {
if (theConverter == null) initConverter();
@@ -575,8 +575,8 @@
* A namespace context for interpreting a prefix within a QName.
* @return
* A string containing a lexical representation of QName
- * @throws IllegalArgumentException if val is null or
- * if nsc is non-null or nsc.getPrefix(nsprefixFromVal) is null.
+ * @throws IllegalArgumentException if {@code val} is null or
+ * if {@code nsc} is non-null or {@code nsc.getPrefix(nsprefixFromVal)} is null.
*/
public static String printQName( javax.xml.namespace.QName val,
NamespaceContext nsc ) {
@@ -591,7 +591,7 @@
* A Calendar value
* @return
* A string containing a lexical representation of xsd:dateTime
- * @throws IllegalArgumentException if val is null.
+ * @throws IllegalArgumentException if {@code val} is null.
*/
public static String printDateTime( java.util.Calendar val ) {
if (theConverter == null) initConverter();
@@ -605,7 +605,7 @@
* An array of bytes
* @return
* A string containing a lexical representation of xsd:base64Binary
- * @throws IllegalArgumentException if val is null.
+ * @throws IllegalArgumentException if {@code val} is null.
*/
public static String printBase64Binary( byte[] val ) {
if (theConverter == null) initConverter();
@@ -619,7 +619,7 @@
* An array of bytes
* @return
* A string containing a lexical representation of xsd:hexBinary
- * @throws IllegalArgumentException if val is null.
+ * @throws IllegalArgumentException if {@code val} is null.
*/
public static String printHexBinary( byte[] val ) {
if (theConverter == null) initConverter();
@@ -659,7 +659,7 @@
* A Calendar value
* @return
* A string containing a lexical representation of xsd:time
- * @throws IllegalArgumentException if val is null.
+ * @throws IllegalArgumentException if {@code val} is null.
*/
public static String printTime( java.util.Calendar val ) {
if (theConverter == null) initConverter();
@@ -673,7 +673,7 @@
* A Calendar value
* @return
* A string containing a lexical representation of xsd:date
- * @throws IllegalArgumentException if val is null.
+ * @throws IllegalArgumentException if {@code val} is null.
*/
public static String printDate( java.util.Calendar val ) {
if (theConverter == null) initConverter();
--- old/src/java.xml.bind/share/classes/javax/xml/bind/DatatypeConverterInterface.java 2015-09-19 13:15:30.468769623 +0300
+++ new/src/java.xml.bind/share/classes/javax/xml/bind/DatatypeConverterInterface.java 2015-09-19 13:15:30.328768929 +0300
@@ -194,7 +194,7 @@
* Converts the string argument into a QName value.
*
*
- * String parameter lexicalXSDQname must conform to lexical value space specifed at
+ * String parameter {@code lexicalXSDQname} must conform to lexical value space specifed at
* XML Schema Part 2:Datatypes specification:QNames
*
* @param lexicalXSDQName
@@ -204,7 +204,7 @@
* @return
* A QName value represented by the string argument.
* @throws IllegalArgumentException if string parameter does not conform to XML Schema Part 2 specification or
- * if namespace prefix of lexicalXSDQname is not bound to a URI in NamespaceContext nsc .
+ * if namespace prefix of {@code lexicalXSDQname} is not bound to a URI in NamespaceContext {@code nsc}.
*/
public javax.xml.namespace.QName parseQName( String lexicalXSDQName,
javax.xml.namespace.NamespaceContext nsc);
@@ -249,7 +249,7 @@
* of xsd:unsignedInt.
* @return
* A long value represented by the string argument.
- * @throws NumberFormatException if string parameter can not be parsed into a long value.
+ * @throws NumberFormatException if string parameter can not be parsed into a {@code long} value.
*/
public long parseUnsignedInt( String lexicalXSDUnsignedInt );
@@ -260,7 +260,7 @@
* representation of xsd:unsignedShort.
* @return
* An int value represented by the string argument.
- * @throws NumberFormatException if string parameter can not be parsed into an int value.
+ * @throws NumberFormatException if string parameter can not be parsed into an {@code int} value.
*/
public int parseUnsignedShort( String lexicalXSDUnsignedShort );
@@ -313,7 +313,7 @@
* A BigInteger value
* @return
* A string containing a lexical representation of xsd:integer
- * @throws IllegalArgumentException val is null.
+ * @throws IllegalArgumentException {@code val} is null.
*/
public String printInteger( java.math.BigInteger val );
@@ -351,7 +351,7 @@
* A BigDecimal value
* @return
* A string containing a lexical representation of xsd:decimal
- * @throws IllegalArgumentException val is null.
+ * @throws IllegalArgumentException {@code val} is null.
*/
public String printDecimal( java.math.BigDecimal val );
@@ -399,8 +399,8 @@
* A namespace context for interpreting a prefix within a QName.
* @return
* A string containing a lexical representation of QName
- * @throws IllegalArgumentException if val is null or
- * if nsc is non-null or nsc.getPrefix(nsprefixFromVal) is null.
+ * @throws IllegalArgumentException if {@code val} is null or
+ * if {@code nsc} is non-null or {@code nsc.getPrefix(nsprefixFromVal)} is null.
*/
public String printQName( javax.xml.namespace.QName val,
javax.xml.namespace.NamespaceContext nsc );
@@ -411,7 +411,7 @@
* A Calendar value
* @return
* A string containing a lexical representation of xsd:dateTime
- * @throws IllegalArgumentException if val is null.
+ * @throws IllegalArgumentException if {@code val} is null.
*/
public String printDateTime( java.util.Calendar val );
@@ -421,7 +421,7 @@
* an array of bytes
* @return
* A string containing a lexical representation of xsd:base64Binary
- * @throws IllegalArgumentException if val is null.
+ * @throws IllegalArgumentException if {@code val} is null.
*/
public String printBase64Binary( byte[] val );
@@ -431,7 +431,7 @@
* an array of bytes
* @return
* A string containing a lexical representation of xsd:hexBinary
- * @throws IllegalArgumentException if val is null.
+ * @throws IllegalArgumentException if {@code val} is null.
*/
public String printHexBinary( byte[] val );
@@ -459,7 +459,7 @@
* A Calendar value
* @return
* A string containing a lexical representation of xsd:time
- * @throws IllegalArgumentException if val is null.
+ * @throws IllegalArgumentException if {@code val} is null.
*/
public String printTime( java.util.Calendar val );
@@ -469,7 +469,7 @@
* A Calendar value
* @return
* A string containing a lexical representation of xsd:date
- * @throws IllegalArgumentException if val is null.
+ * @throws IllegalArgumentException if {@code val} is null.
*/
public String printDate( java.util.Calendar val );
--- old/src/java.xml.bind/share/classes/javax/xml/bind/JAXB.java 2015-09-19 13:15:30.968772103 +0300
+++ new/src/java.xml.bind/share/classes/javax/xml/bind/JAXB.java 2015-09-19 13:15:30.828771408 +0300
@@ -68,7 +68,7 @@
*
*
*
- * In addition, the unmarshal methods have the following characteristic:
+ * In addition, the {@code unmarshal} methods have the following characteristic:
*
*
* Schema validation is not performed on the input XML.
@@ -78,7 +78,7 @@
*
*
*
- * Similarly, the marshal methods have the following characteristic:
+ * Similarly, the {@code marshal} methods have the following characteristic:
*
* The processing will try to continue even if the Java object tree
* does not meet the validity requirement. Only as
@@ -88,7 +88,7 @@
*
*
* All the methods on this class require non-null arguments to all parameters.
- * The unmarshal methods either fail with an exception or return
+ * The {@code unmarshal} methods either fail with an exception or return
* a non-null value.
*
* @author Kohsuke Kawaguchi
@@ -179,7 +179,7 @@
*
* @param xml
* The URI is {@link URI#toURL() turned into URL} and then
- * follows the handling of URL .
+ * follows the handling of {@code URL}.
*/
public static T unmarshal( URI xml, Class type ) {
try {
@@ -196,9 +196,9 @@
* Reads in a Java object tree from the given XML input.
*
* @param xml
- * The string is first interpreted as an absolute URI .
+ * The string is first interpreted as an absolute {@code URI}.
* If it's not {@link URI#isAbsolute() a valid absolute URI},
- * then it's interpreted as a File
+ * then it's interpreted as a {@code File}
*/
public static T unmarshal( String xml, Class type ) {
try {
@@ -347,8 +347,8 @@
*
* @param xml
* The XML will be {@link URLConnection#getOutputStream() sent} to the
- * resource pointed by this URL. Note that not all URL s support
- * such operation, and exact semantics depends on the URL
+ * resource pointed by this URL. Note that not all {@code URL}s support
+ * such operation, and exact semantics depends on the {@code URL}
* implementations. In case of {@link HttpURLConnection HTTP URLs},
* this will perform HTTP POST.
*
@@ -374,7 +374,7 @@
*
* @param xml
* The URI is {@link URI#toURL() turned into URL} and then
- * follows the handling of URL . See above.
+ * follows the handling of {@code URL}. See above.
*
* @throws DataBindingException
* If the operation fails, such as due to I/O error, unbindable classes.
@@ -397,9 +397,9 @@
* This parameter must not be null.
*
* @param xml
- * The string is first interpreted as an absolute URI .
+ * The string is first interpreted as an absolute {@code URI}.
* If it's not {@link URI#isAbsolute() a valid absolute URI},
- * then it's interpreted as a File
+ * then it's interpreted as a {@code File}
*
* @throws DataBindingException
* If the operation fails, such as due to I/O error, unbindable classes.
@@ -522,19 +522,19 @@
*
* {@link URL}
* The XML will be {@link URLConnection#getOutputStream() sent} to the
- * resource pointed by this URL. Note that not all URL s support
- * such operation, and exact semantics depends on the URL
+ * resource pointed by this URL. Note that not all {@code URL}s support
+ * such operation, and exact semantics depends on the {@code URL}
* implementations. In case of {@link HttpURLConnection HTTP URLs},
* this will perform HTTP POST.
*
* {@link URI}
* The URI is {@link URI#toURL() turned into URL} and then
- * follows the handling of URL . See above.
+ * follows the handling of {@code URL}. See above.
*
* {@link String}
- * The string is first interpreted as an absolute URI .
+ * The string is first interpreted as an absolute {@code URI}.
* If it's not {@link URI#isAbsolute() a valid absolute URI},
- * then it's interpreted as a File
+ * then it's interpreted as a {@code File}
*
* {@link OutputStream}
* The XML will be sent to the given {@link OutputStream}.
--- old/src/java.xml.bind/share/classes/javax/xml/bind/JAXBContextFactory.java 2015-09-19 13:15:31.468774582 +0300
+++ new/src/java.xml.bind/share/classes/javax/xml/bind/JAXBContextFactory.java 2015-09-19 13:15:31.332773908 +0300
@@ -38,7 +38,7 @@
/**
*
- * Create a new instance of a JAXBContext class.
+ * Create a new instance of a {@code JAXBContext} class.
*
*
* For semantics see {@link javax.xml.bind.JAXBContext#newInstance(Class[], java.util.Map)}
@@ -52,11 +52,11 @@
* in an empty map.
*
* @return
- * A new instance of a JAXBContext .
+ * A new instance of a {@code JAXBContext}.
*
* @throws JAXBException
* if an error was encountered while creating the
- * JAXBContext , such as (but not limited to):
+ * {@code JAXBContext}, such as (but not limited to):
*
* Classes use JAXB annotations incorrectly
* Classes have colliding annotations (i.e., two classes with the same type name)
@@ -75,14 +75,14 @@
/**
*
- * Create a new instance of a JAXBContext class.
+ * Create a new instance of a {@code JAXBContext} class.
*
*
* For semantics see {@link javax.xml.bind.JAXBContext#newInstance(String, ClassLoader, java.util.Map)}
*
*
* The interpretation of properties is up to implementations. Implementations should
- * throw JAXBException if it finds properties that it doesn't understand.
+ * throw {@code JAXBException} if it finds properties that it doesn't understand.
*
* @param contextPath list of java package names that contain schema derived classes
* @param classLoader
@@ -91,9 +91,9 @@
* provider-specific properties. Can be null, which means the same thing as passing
* in an empty map.
*
- * @return a new instance of a JAXBContext
+ * @return a new instance of a {@code JAXBContext}
* @throws JAXBException if an error was encountered while creating the
- * JAXBContext such as
+ * {@code JAXBContext} such as
*
* failure to locate either ObjectFactory.class or jaxb.index in the packages
* an ambiguity among global elements contained in the contextPath
--- old/src/java.xml.bind/share/classes/javax/xml/bind/JAXBElement.java 2015-09-19 13:15:31.956777002 +0300
+++ new/src/java.xml.bind/share/classes/javax/xml/bind/JAXBElement.java 2015-09-19 13:15:31.820776328 +0300
@@ -35,25 +35,25 @@
* declaration within a schema and the element instance value within an xml document
* with the following properties
*
- * element's xml tag name
- * value element declaration's declaredType xs:element @type attribute)
- * scope boolean nil xsi:nil
+ * element's xml tag {@code name}
+ * {@code value} represents the element instance's atttribute(s) and content modelelement declaration's {@code declaredType} ({@code xs:element @type} attribute)
+ * {@code scope} of element declarationboolean {@code nil} property. (element instance's {@code xsi:nil} attribute)
*
*
- * The declaredType and scope property are the
+ *
The {@code declaredType} and {@code scope} property are the
* JAXB class binding for the xml type definition.
*
*
- * Scope
{@code Scope} is either {@link GlobalScope} or the Java class representing the
* complex type definition containing the schema element declaration.
*
*
- * There is a property constraint that if value null ,
- * then nil must be true . The converse is not true to enable
- * representing a nil element with attribute(s). If nil is true, it is possible
- * that value is non-null so it can hold the value of the attributes
+ *
There is a property constraint that if {@code value} is {@code null},
+ * then {@code nil} must be {@code true}. The converse is not true to enable
+ * representing a nil element with attribute(s). If {@code nil} is true, it is possible
+ * that {@code value} is non-null so it can hold the value of the attributes
* associated with a nil element.
*
*
@@ -97,7 +97,7 @@
* @param declaredType Java binding of xml element declaration's type
* @param scope
* Java binding of scope of xml element declaration.
- * Passing null is the same as passing GlobalScope.class
+ * Passing null is the same as passing {@code GlobalScope.class}
* @param value
* Java instance representing xml element's value.
* @see #getScope()
@@ -119,7 +119,7 @@
/**
* Construct an xml element instance.
*
- * This is just a convenience method for new JAXBElement(name,declaredType,GlobalScope.class,value)
+ * This is just a convenience method for {@code new JAXBElement(name,declaredType,GlobalScope.class,value)}
*/
public JAXBElement(QName name, Class declaredType, T value ) {
this(name,declaredType,GlobalScope.class,value);
@@ -142,7 +142,7 @@
/**
* Set the content model and attributes of this xml element.
*
- * When this property is set to null , isNil() must by true .
+ *
When this property is set to {@code null}, {@code isNil()} must by {@code true}.
* Details of constraint are described at {@link #isNil()}.
*
* @see #isTypeSubstituted()
@@ -155,7 +155,7 @@
* Return the content model and attribute values for this element.
*
* See {@link #isNil()} for a description of a property constraint when
- * this value is null
+ * this value is {@code null}
*/
public T getValue() {
return value;
@@ -165,18 +165,18 @@
* Returns scope of xml element declaration.
*
* @see #isGlobalScope()
- * @return GlobalScope.class if this element is of global scope.
+ * @return {@code GlobalScope.class} if this element is of global scope.
*/
public Class getScope() {
return scope;
}
/**
- * Returns true iff this element instance content model
+ *
Returns {@code true} iff this element instance content model
* is nil.
*
- * This property always returns true when {@link #getValue()} is null.
- * Note that the converse is not true, when this property is true ,
+ *
This property always returns {@code true} when {@link #getValue()} is null.
+ * Note that the converse is not true, when this property is {@code true},
* {@link #getValue()} can contain a non-null value for attribute(s). It is
* valid for a nil xml element to have attribute(s).
*/
--- old/src/java.xml.bind/share/classes/javax/xml/bind/JAXBException.java 2015-09-19 13:15:32.456779481 +0300
+++ new/src/java.xml.bind/share/classes/javax/xml/bind/JAXBException.java 2015-09-19 13:15:32.320778807 +0300
@@ -160,7 +160,7 @@
/**
* Prints this JAXBException and its stack trace (including the stack trace
- * of the linkedException if it is non-null) to System.err .
+ * of the linkedException if it is non-null) to {@code System.err}.
*
*/
public void printStackTrace() {
--- old/src/java.xml.bind/share/classes/javax/xml/bind/JAXBIntrospector.java 2015-09-19 13:15:32.948781921 +0300
+++ new/src/java.xml.bind/share/classes/javax/xml/bind/JAXBIntrospector.java 2015-09-19 13:15:32.808781227 +0300
@@ -74,7 +74,7 @@
*
* Convenience method to abstract whether working with either
* a javax.xml.bind.JAXBElement instance or an instance of
- * @XmlRootElement annotated Java class.
+ * {@code @XmlRootElement} annotated Java class.
*
* @param jaxbElement object that #isElement(Object) returns true.
*
--- old/src/java.xml.bind/share/classes/javax/xml/bind/MarshalException.java 2015-09-19 13:15:33.436784341 +0300
+++ new/src/java.xml.bind/share/classes/javax/xml/bind/MarshalException.java 2015-09-19 13:15:33.304783686 +0300
@@ -30,7 +30,7 @@
* a marshal operation that the provider is unable to recover from.
*
*
- * The ValidationEventHandler can cause this exception to be thrown
+ * The {@code ValidationEventHandler} can cause this exception to be thrown
* during the marshal operations. See
* {@link ValidationEventHandler#handleEvent(ValidationEvent)
* ValidationEventHandler.handleEvent(ValidationEvent)}.
--- old/src/java.xml.bind/share/classes/javax/xml/bind/Marshaller.java 2015-09-19 13:15:33.928786781 +0300
+++ new/src/java.xml.bind/share/classes/javax/xml/bind/Marshaller.java 2015-09-19 13:15:33.788786086 +0300
@@ -33,7 +33,7 @@
/**
*
- * The Marshaller class is responsible for governing the process
+ * The {@code Marshaller} class is responsible for governing the process
* of serializing Java content trees back into XML data. It provides the basic
* marshalling methods:
*
@@ -153,15 +153,15 @@
* Marshalling content tree rooted by a JAXB element
* The first parameter of the overloaded
- * Marshaller.marshal(java.lang.Object, ...) methods must be a
+ * {@code Marshaller.marshal(java.lang.Object, ...)} methods must be a
* JAXB element as computed by
* {@link JAXBIntrospector#isElement(java.lang.Object)};
- * otherwise, a Marshaller.marshal method must throw a
+ * otherwise, a {@code Marshaller.marshal} method must throw a
* {@link MarshalException}. There exist two mechanisms
* to enable marshalling an instance that is not a JAXB element.
* One method is to wrap the instance as a value of a {@link JAXBElement},
* and pass the wrapper element as the first parameter to
- * a Marshaller.marshal method. For java to schema binding, it
+ * a {@code Marshaller.marshal} method. For java to schema binding, it
* is also possible to simply annotate the instance's class with
* @{@link XmlRootElement}.
*
@@ -170,7 +170,7 @@
* Encoding
* By default, the Marshaller will use UTF-8 encoding when generating XML data
- * to a java.io.OutputStream , or a java.io.Writer . Use the
+ * to a {@code java.io.OutputStream}, or a {@code java.io.Writer}. Use the
* {@link #setProperty(String,Object) setProperty} API to change the output
* encoding used during these marshal operations. Client applications are
* expected to supply a valid character encoding name as defined in the
@@ -188,7 +188,7 @@
* order to marshal it back into XML data. Different JAXB Providers will
* support marshalling invalid Java content trees at varying levels, however
* all JAXB Providers must be able to marshal a valid content tree back to
- * XML data. A JAXB Provider must throw a MarshalException when it
+ * XML data. A JAXB Provider must throw a {@code MarshalException} when it
* is unable to complete the marshal operation due to invalid content. Some
* JAXB Providers will fully allow marshalling invalid content, others will fail
* on the first validation error.
@@ -213,18 +213,18 @@
* All JAXB Providers are required to support the following set of properties.
* Some providers may support additional properties.
*
- * jaxb.encoding - value must be a java.lang.String{@code jaxb.encoding} - value must be a java.lang.String
* The output encoding to use when marshalling the XML data. The
* Marshaller will use "UTF-8" by default if this property is not
* specified.
- * jaxb.formatted.output - value must be a java.lang.Boolean{@code jaxb.formatted.output} - value must be a java.lang.Boolean
* This property controls whether or not the Marshaller will format
* the resulting XML data with line breaks and indentation. A
* true value for this property indicates human readable indented
* xml data, while a false value indicates unformatted xml data.
* The Marshaller will default to false (unformatted) if this
* property is not specified.
- * jaxb.schemaLocation - value must be a java.lang.String{@code jaxb.schemaLocation} - value must be a java.lang.String
* This property allows the client application to specify an
* xsi:schemaLocation attribute in the generated XML data. The format of
* the schemaLocation attribute value is discussed in an easy to
@@ -233,7 +233,7 @@
* of the W3C XML Schema Part 0: Primer and specified in
*
* Section 2.6 of the W3C XML Schema Part 1: Structures .
- * jaxb.noNamespaceSchemaLocation - value must be a java.lang.String{@code jaxb.noNamespaceSchemaLocation} - value must be a java.lang.String
* This property allows the client application to specify an
* xsi:noNamespaceSchemaLocation attribute in the generated XML
* data. The format of the schemaLocation attribute value is discussed in
@@ -242,10 +242,10 @@
* of the W3C XML Schema Part 0: Primer and specified in
*
* Section 2.6 of the W3C XML Schema Part 1: Structures .
- * jaxb.fragment - value must be a java.lang.Boolean{@code jaxb.fragment} - value must be a java.lang.Boolean
* This property determines whether or not document level events will be
* generated by the Marshaller. If the property is not specified, the
- * default is false . This property has different implications depending
+ * default is {@code false}. This property has different implications depending
* on which marshal api you are using - when this property is set to true:
* {@link #marshal(Object,org.xml.sax.ContentHandler) marshal(Object,ContentHandler)} - the Marshaller won't
@@ -352,15 +352,15 @@
"jaxb.fragment";
/**
- * Marshal the content tree rooted at jaxbElement into the specified
- * javax.xml.transform.Result .
+ * Marshal the content tree rooted at {@code jaxbElement} into the specified
+ * {@code javax.xml.transform.Result}.
*
*
* All JAXB Providers must at least support
* {@link javax.xml.transform.dom.DOMResult},
* {@link javax.xml.transform.sax.SAXResult}, and
* {@link javax.xml.transform.stream.StreamResult}. It can
- * support other derived classes of Result as well.
+ * support other derived classes of {@code Result} as well.
*
* @param jaxbElement
* The root of content tree to be marshalled.
@@ -371,9 +371,9 @@
* If any unexpected problem occurs during the marshalling.
* @throws MarshalException
* If the {@link ValidationEventHandler ValidationEventHandler}
- * returns false from its handleEvent method or the
- * Marshaller is unable to marshal obj (or any
- * object reachable from obj ). See
+ * returns false from its {@code handleEvent} method or the
+ * {@code Marshaller} is unable to marshal {@code obj} (or any
+ * object reachable from {@code obj}). See
* Marshalling a JAXB element .
* @throws IllegalArgumentException
* If any of the method parameters are null
@@ -382,7 +382,7 @@
throws JAXBException;
/**
- * Marshal the content tree rooted at jaxbElement into an output stream.
+ * Marshal the content tree rooted at {@code jaxbElement} into an output stream.
*
* @param jaxbElement
* The root of content tree to be marshalled.
@@ -393,9 +393,9 @@
* If any unexpected problem occurs during the marshalling.
* @throws MarshalException
* If the {@link ValidationEventHandler ValidationEventHandler}
- * returns false from its handleEvent method or the
- * Marshaller is unable to marshal obj (or any
- * object reachable from obj ). See
+ * returns false from its {@code handleEvent} method or the
+ * {@code Marshaller} is unable to marshal {@code obj} (or any
+ * object reachable from {@code obj}). See
* Marshalling a JAXB element .
* @throws IllegalArgumentException
* If any of the method parameters are null
@@ -404,7 +404,7 @@
throws JAXBException;
/**
- * Marshal the content tree rooted at jaxbElement into a file.
+ * Marshal the content tree rooted at {@code jaxbElement} into a file.
*
* @param jaxbElement
* The root of content tree to be marshalled.
@@ -415,9 +415,9 @@
* If any unexpected problem occurs during the marshalling.
* @throws MarshalException
* If the {@link ValidationEventHandler ValidationEventHandler}
- * returns false from its handleEvent method or the
- * Marshaller is unable to marshal obj (or any
- * object reachable from obj ). See
+ * returns false from its {@code handleEvent} method or the
+ * {@code Marshaller} is unable to marshal {@code obj} (or any
+ * object reachable from {@code obj}). See
* Marshalling a JAXB element .
* @throws IllegalArgumentException
* If any of the method parameters are null
@@ -427,7 +427,7 @@
throws JAXBException;
/**
- * Marshal the content tree rooted at jaxbElement into a Writer.
+ * Marshal the content tree rooted at {@code jaxbElement} into a Writer.
*
* @param jaxbElement
* The root of content tree to be marshalled.
@@ -438,9 +438,9 @@
* If any unexpected problem occurs during the marshalling.
* @throws MarshalException
* If the {@link ValidationEventHandler ValidationEventHandler}
- * returns false from its handleEvent method or the
- * Marshaller is unable to marshal obj (or any
- * object reachable from obj ). See
+ * returns false from its {@code handleEvent} method or the
+ * {@code Marshaller} is unable to marshal {@code obj} (or any
+ * object reachable from {@code obj}). See
* Marshalling a JAXB element .
* @throws IllegalArgumentException
* If any of the method parameters are null
@@ -449,7 +449,7 @@
throws JAXBException;
/**
- * Marshal the content tree rooted at jaxbElement into SAX2 events.
+ * Marshal the content tree rooted at {@code jaxbElement} into SAX2 events.
*
* @param jaxbElement
* The root of content tree to be marshalled.
@@ -460,9 +460,9 @@
* If any unexpected problem occurs during the marshalling.
* @throws MarshalException
* If the {@link ValidationEventHandler ValidationEventHandler}
- * returns false from its handleEvent method or the
- * Marshaller is unable to marshal obj (or any
- * object reachable from obj ). See
+ * returns false from its {@code handleEvent} method or the
+ * {@code Marshaller} is unable to marshal {@code obj} (or any
+ * object reachable from {@code obj}). See
* Marshalling a JAXB element .
* @throws IllegalArgumentException
* If any of the method parameters are null
@@ -471,7 +471,7 @@
throws JAXBException;
/**
- * Marshal the content tree rooted at jaxbElement into a DOM tree.
+ * Marshal the content tree rooted at {@code jaxbElement} into a DOM tree.
*
* @param jaxbElement
* The content tree to be marshalled.
@@ -486,9 +486,9 @@
* If any unexpected problem occurs during the marshalling.
* @throws MarshalException
* If the {@link ValidationEventHandler ValidationEventHandler}
- * returns false from its handleEvent method or the
- * Marshaller is unable to marshal jaxbElement (or any
- * object reachable from jaxbElement ). See
+ * returns false from its {@code handleEvent} method or the
+ * {@code Marshaller} is unable to marshal {@code jaxbElement} (or any
+ * object reachable from {@code jaxbElement}). See
* Marshalling a JAXB element .
* @throws IllegalArgumentException
* If any of the method parameters are null
@@ -497,7 +497,7 @@
throws JAXBException;
/**
- * Marshal the content tree rooted at jaxbElement into a
+ * Marshal the content tree rooted at {@code jaxbElement} into a
* {@link javax.xml.stream.XMLStreamWriter}.
*
* @param jaxbElement
@@ -509,9 +509,9 @@
* If any unexpected problem occurs during the marshalling.
* @throws MarshalException
* If the {@link ValidationEventHandler ValidationEventHandler}
- * returns false from its handleEvent method or the
- * Marshaller is unable to marshal obj (or any
- * object reachable from obj ). See
+ * returns false from its {@code handleEvent} method or the
+ * {@code Marshaller} is unable to marshal {@code obj} (or any
+ * object reachable from {@code obj}). See
* Marshalling a JAXB element .
* @throws IllegalArgumentException
* If any of the method parameters are null
@@ -521,7 +521,7 @@
throws JAXBException;
/**
- * Marshal the content tree rooted at jaxbElement into a
+ * Marshal the content tree rooted at {@code jaxbElement} into a
* {@link javax.xml.stream.XMLEventWriter}.
*
* @param jaxbElement
@@ -533,9 +533,9 @@
* If any unexpected problem occurs during the marshalling.
* @throws MarshalException
* If the {@link ValidationEventHandler ValidationEventHandler}
- * returns false from its handleEvent method or the
- * Marshaller is unable to marshal obj (or any
- * object reachable from obj ). See
+ * returns false from its {@code handleEvent} method or the
+ * {@code Marshaller} is unable to marshal {@code obj} (or any
+ * object reachable from {@code obj}). See
* Marshalling a JAXB element .
* @throws IllegalArgumentException
* If any of the method parameters are null
@@ -572,7 +572,7 @@
/**
* Set the particular property in the underlying implementation of
- * Marshaller . This method can only be used to set one of
+ * {@code Marshaller}. This method can only be used to set one of
* the standard JAXB defined properties above or a provider specific
* property. Attempting to set an undefined property will result in
* a PropertyException being thrown. See
@@ -593,7 +593,7 @@
/**
* Get the particular property in the underlying implementation of
- * Marshaller . This method can only be used to get one of
+ * {@code Marshaller}. This method can only be used to get one of
* the standard JAXB defined properties above or a provider specific
* property. Attempting to get an undefined property will result in
* a PropertyException being thrown. See
@@ -648,7 +648,7 @@
* Associates a configured instance of {@link XmlAdapter} with this marshaller.
*
*
- * This is a convenience method that invokes setAdapter(adapter.getClass(),adapter);.
+ * This is a convenience method that invokes {@code setAdapter(adapter.getClass(),adapter);}.
*
* @see #setAdapter(Class,XmlAdapter)
* @throws IllegalArgumentException
@@ -724,7 +724,7 @@
* This method allows the caller to validate the marshalled XML as it's marshalled.
*
*
- * Initially this property is set to null .
+ * Initially this property is set to {@code null}.
*
* @param schema Schema object to validate marshal operations against or null to disable validation
* @throws UnsupportedOperationException could be thrown if this method is
@@ -771,11 +771,11 @@
public static abstract class Listener {
/**
*
- * Callback method invoked before marshalling from source to XML.
+ * Callback method invoked before marshalling from {@code source} to XML.
*
*
- * This method is invoked just before marshalling process starts to marshal source .
- * Note that if the class of source defines its own beforeMarshal method,
+ * This method is invoked just before marshalling process starts to marshal {@code source}.
+ * Note that if the class of {@code source} defines its own {@code beforeMarshal} method,
* the class specific callback method is invoked just before this method is invoked.
*
* @param source instance of JAXB mapped class prior to marshalling from it.
@@ -785,11 +785,11 @@
/**
*
- * Callback method invoked after marshalling source to XML.
+ * Callback method invoked after marshalling {@code source} to XML.
*
*
- * This method is invoked after source and all its descendants have been marshalled.
- * Note that if the class of source defines its own afterMarshal method,
+ * This method is invoked after {@code source} and all its descendants have been marshalled.
+ * Note that if the class of {@code source} defines its own {@code afterMarshal} method,
* the class specific callback method is invoked just before this method is invoked.
*
* @param source instance of JAXB mapped class after marshalling it.
@@ -804,7 +804,7 @@
*
*
* There is only one Listener per Marshaller. Setting a Listener replaces the previous set Listener.
- * One can unregister current Listener by setting listener to null .
+ * One can unregister current Listener by setting listener to {@code null}.
*
* @param listener an instance of a class that implements {@link Listener}
* @since 1.6, JAXB 2.0
@@ -814,7 +814,8 @@
/**
*
Return {@link Listener} registered with this {@link Marshaller}.
*
- * @return registered {@link Listener} or null if no Listener is registered with this Marshaller.
+ * @return registered {@link Listener} or {@code null}
+ * if no Listener is registered with this Marshaller.
* @since 1.6, JAXB 2.0
*/
public Listener getListener();
--- old/src/java.xml.bind/share/classes/javax/xml/bind/TypeConstraintException.java 2015-09-19 13:15:34.660790410 +0300
+++ new/src/java.xml.bind/share/classes/javax/xml/bind/TypeConstraintException.java 2015-09-19 13:15:34.308788665 +0300
@@ -174,7 +174,7 @@
/**
* Prints this TypeConstraintException and its stack trace (including the stack trace
- * of the linkedException if it is non-null) to System.err .
+ * of the linkedException if it is non-null) to {@code System.err}.
*
*/
public void printStackTrace() {
--- old/src/java.xml.bind/share/classes/javax/xml/bind/UnmarshalException.java 2015-09-19 13:15:35.160792890 +0300
+++ new/src/java.xml.bind/share/classes/javax/xml/bind/UnmarshalException.java 2015-09-19 13:15:35.012792156 +0300
@@ -31,7 +31,7 @@
* the operation.
*
*
- * The ValidationEventHandler can cause this exception to be thrown
+ * The {@code ValidationEventHandler} can cause this exception to be thrown
* during the unmarshal operations. See
* {@link ValidationEventHandler#handleEvent(ValidationEvent)
* ValidationEventHandler.handleEvent(ValidationEvent)}.
--- old/src/java.xml.bind/share/classes/javax/xml/bind/Unmarshaller.java 2015-09-19 13:15:35.652795330 +0300
+++ new/src/java.xml.bind/share/classes/javax/xml/bind/Unmarshaller.java 2015-09-19 13:15:35.512794635 +0300
@@ -31,7 +31,7 @@
import java.io.Reader;
/**
- * The Unmarshaller class governs the process of deserializing XML
+ * The {@code Unmarshaller} class governs the process of deserializing XML
* data into newly created Java content trees, optionally validating the XML
* data as it is unmarshalled. It provides an overloading of unmarshal methods
* for many different input kinds.
@@ -71,7 +71,7 @@
*
*
* Unmarshalling from a StringBuffer using a
- * javax.xml.transform.stream.StreamSource :
+ * {@code javax.xml.transform.stream.StreamSource}:
*
* {@code
* JAXBContext jc = JAXBContext.newInstance( "com.acme.foo" );
@@ -82,7 +82,7 @@
*
*
*
- * Unmarshalling from a org.w3c.dom.Node :
+ * Unmarshalling from a {@code org.w3c.dom.Node}:
*
*
* JAXBContext jc = JAXBContext.newInstance( "com.acme.foo" );
@@ -98,7 +98,7 @@
*
*
*
- * Unmarshalling from a javax.xml.transform.sax.SAXSource using a
+ * Unmarshalling from a {@code javax.xml.transform.sax.SAXSource} using a
* client specified validating SAX2.0 parser:
*
*
@@ -205,17 +205,17 @@
* Unmarshal a root element that is globally declared
- * The unmarshal methods that do not have an declaredType parameter use
+ * The unmarshal methods that do not have an {@code declaredType} parameter use
* {@link JAXBContext} to unmarshal the root element of an XML data. The {@link JAXBContext}
- * instance is the one that was used to create this Unmarshaller . The {@link JAXBContext}
+ * instance is the one that was used to create this {@code Unmarshaller}. The {@link JAXBContext}
* instance maintains a mapping of globally declared XML element and type definition names to
* JAXB mapped classes. The unmarshal method checks if {@link JAXBContext} has a mapping
- * from the root element's XML name and/or @xsi:type to a JAXB mapped class. If it does, it umarshalls the
+ * from the root element's XML name and/or {@code @xsi:type} to a JAXB mapped class. If it does, it umarshalls the
* XML data using the appropriate JAXB mapped class. Note that when the root element name is unknown and the root
- * element has an @xsi:type , the XML data is unmarshalled
+ * element has an {@code @xsi:type}, the XML data is unmarshalled
* using that JAXB mapped class as the value of a {@link JAXBElement}.
* When the {@link JAXBContext} object does not have a mapping for the root element's name
- * nor its @xsi:type , if it exists,
+ * nor its {@code @xsi:type}, if it exists,
* then the unmarshal operation will abort immediately by throwing a {@link UnmarshalException
* UnmarshalException}. This exception scenario can be worked around by using the unmarshal by
* declaredType methods described in the next subsection.
@@ -225,20 +225,20 @@
* Unmarshal by Declared Type
- * The unmarshal methods with a declaredType parameter enable an
+ * The unmarshal methods with a {@code declaredType} parameter enable an
* application to deserialize a root element of XML data, even when
* there is no mapping in {@link JAXBContext} of the root element's XML name.
* The unmarshaller unmarshals the root element using the application provided
- * mapping specified as the declaredType parameter.
+ * mapping specified as the {@code declaredType} parameter.
* Note that even when the root element's element name is mapped by {@link JAXBContext},
- * the declaredType parameter overrides that mapping for
+ * the {@code declaredType} parameter overrides that mapping for
* deserializing the root element when using these unmarshal methods.
- * Additionally, when the root element of XML data has an xsi:type attribute and
+ * Additionally, when the root element of XML data has an {@code xsi:type} attribute and
* that attribute's value references a type definition that is mapped
* to a JAXB mapped class by {@link JAXBContext}, that the root
- * element's xsi:type attribute takes
- * precedence over the unmarshal methods declaredType parameter.
- * These methods always return a {@literal JAXBElement}
+ * element's {@code xsi:type} attribute takes
+ * precedence over the unmarshal methods {@code declaredType} parameter.
+ * These methods always return a {@code JAXBElement}
* instance. The table below shows how the properties of the returned JAXBElement
* instance are set.
*
@@ -255,21 +255,21 @@
*
*
* name
- * xml element name{@code xml element name}
*
*
*
*
* value
- * instanceof declaredType{@code instanceof declaredType}
*
*
* declaredType
- * unmarshal method declaredType parameter
+ * unmarshal method {@code declaredType} parameter
*
*
* scope
- * null (actual scope is unknown) {@code null} (actual scope is unknown)
*
*
*
@@ -279,7 +279,7 @@
* The following is an example of
* unmarshal by declaredType method .
*
- * Unmarshal by declaredType from a org.w3c.dom.Node :
+ * Unmarshal by declaredType from a {@code org.w3c.dom.Node}:
*
* {@code
* Schema fragment for example
@@ -330,7 +330,7 @@
*
*
* A client application can enable or disable JAXP 1.3 validation
- * mechanism via the setSchema(javax.xml.validation.Schema) API.
+ * mechanism via the {@code setSchema(javax.xml.validation.Schema)} API.
* Sophisticated clients can specify their own validating SAX 2.0 compliant
* parser and bypass the JAXP 1.3 validation mechanism using the
* {@link #unmarshal(javax.xml.transform.Source) unmarshal(Source)} API.
@@ -421,8 +421,8 @@
* If any unexpected errors occur while unmarshalling
* @throws UnmarshalException
* If the {@link ValidationEventHandler ValidationEventHandler}
- * returns false from its handleEvent method or the
- * Unmarshaller is unable to perform the XML to Java
+ * returns false from its {@code handleEvent} method or the
+ * {@code Unmarshaller} is unable to perform the XML to Java
* binding. See Unmarshalling XML Data
* @throws IllegalArgumentException
* If the file parameter is null
@@ -444,8 +444,8 @@
* If any unexpected errors occur while unmarshalling
* @throws UnmarshalException
* If the {@link ValidationEventHandler ValidationEventHandler}
- * returns false from its handleEvent method or the
- * Unmarshaller is unable to perform the XML to Java
+ * returns false from its {@code handleEvent} method or the
+ * {@code Unmarshaller} is unable to perform the XML to Java
* binding. See Unmarshalling XML Data
* @throws IllegalArgumentException
* If the InputStream parameter is null
@@ -468,8 +468,8 @@
* If any unexpected errors occur while unmarshalling
* @throws UnmarshalException
* If the {@link ValidationEventHandler ValidationEventHandler}
- * returns false from its handleEvent method or the
- * Unmarshaller is unable to perform the XML to Java
+ * returns false from its {@code handleEvent} method or the
+ * {@code Unmarshaller} is unable to perform the XML to Java
* binding. See Unmarshalling XML Data
* @throws IllegalArgumentException
* If the InputStream parameter is null
@@ -491,8 +491,8 @@
* If any unexpected errors occur while unmarshalling
* @throws UnmarshalException
* If the {@link ValidationEventHandler ValidationEventHandler}
- * returns false from its handleEvent method or the
- * Unmarshaller is unable to perform the XML to Java
+ * returns false from its {@code handleEvent} method or the
+ * {@code Unmarshaller} is unable to perform the XML to Java
* binding. See Unmarshalling XML Data
* @throws IllegalArgumentException
* If the URL parameter is null
@@ -513,8 +513,8 @@
* If any unexpected errors occur while unmarshalling
* @throws UnmarshalException
* If the {@link ValidationEventHandler ValidationEventHandler}
- * returns false from its handleEvent method or the
- * Unmarshaller is unable to perform the XML to Java
+ * returns false from its {@code handleEvent} method or the
+ * {@code Unmarshaller} is unable to perform the XML to Java
* binding. See Unmarshalling XML Data
* @throws IllegalArgumentException
* If the InputSource parameter is null
@@ -537,8 +537,8 @@
* If any unexpected errors occur while unmarshalling
* @throws UnmarshalException
* If the {@link ValidationEventHandler ValidationEventHandler}
- * returns false from its handleEvent method or the
- * Unmarshaller is unable to perform the XML to Java
+ * returns false from its {@code handleEvent} method or the
+ * {@code Unmarshaller} is unable to perform the XML to Java
* binding. See Unmarshalling XML Data
* @throws IllegalArgumentException
* If the Node parameter is null
@@ -547,7 +547,7 @@
public Object unmarshal( org.w3c.dom.Node node ) throws JAXBException;
/**
- * Unmarshal XML data by JAXB mapped declaredType
+ * Unmarshal XML data by JAXB mapped {@code declaredType}
* and return the resulting content tree.
*
*
@@ -557,16 +557,16 @@
* the document/element to unmarshal XML data from.
* The caller must support at least Document and Element.
* @param declaredType
- * appropriate JAXB mapped class to hold node 's XML data.
+ * appropriate JAXB mapped class to hold {@code node}'s XML data.
*
- * @return JAXB Element representation of node
+ * @return JAXB Element representation of {@code node}
*
* @throws JAXBException
* If any unexpected errors occur while unmarshalling
* @throws UnmarshalException
* If the {@link ValidationEventHandler ValidationEventHandler}
- * returns false from its handleEvent method or the
- * Unmarshaller is unable to perform the XML to Java
+ * returns false from its {@code handleEvent} method or the
+ * {@code Unmarshaller} is unable to perform the XML to Java
* binding. See Unmarshalling XML Data
* @throws IllegalArgumentException
* If any parameter is null
@@ -588,30 +588,30 @@
* A client application can choose not to use the default parser mechanism
* supplied with their JAXB provider. Any SAX 2.0 compliant parser can be
* substituted for the JAXB provider's default mechanism. To do so, the
- * client application must properly configure a SAXSource containing
- * an XMLReader implemented by the SAX 2.0 parser provider. If the
- * XMLReader has an org.xml.sax.ErrorHandler registered
+ * client application must properly configure a {@code SAXSource} containing
+ * an {@code XMLReader} implemented by the SAX 2.0 parser provider. If the
+ * {@code XMLReader} has an {@code org.xml.sax.ErrorHandler} registered
* on it, it will be replaced by the JAXB Provider so that validation errors
- * can be reported via the ValidationEventHandler mechanism of
- * JAXB. If the SAXSource does not contain an XMLReader ,
+ * can be reported via the {@code ValidationEventHandler} mechanism of
+ * JAXB. If the {@code SAXSource} does not contain an {@code XMLReader},
* then the JAXB provider's default parser mechanism will be used.
*
* This parser replacement mechanism can also be used to replace the JAXB
* provider's unmarshal-time validation engine. The client application
* must properly configure their SAX 2.0 compliant parser to perform
- * validation (as shown in the example above). Any SAXParserExceptions
- * encountered by the parser during the unmarshal operation will be
+ * validation (as shown in the example above). Any {@code SAXParserExceptions}
+ * encountered by the parser during the unmarshal operation will be
* processed by the JAXB provider and converted into JAXB
- * ValidationEvent objects which will be reported back to the
- * client via the ValidationEventHandler registered with the
- * Unmarshaller . Note: specifying a substitute validating
+ * {@code ValidationEvent} objects which will be reported back to the
+ * client via the {@code ValidationEventHandler} registered with the
+ * {@code Unmarshaller}. Note: specifying a substitute validating
* SAX 2.0 parser for unmarshalling does not necessarily replace the
* validation engine used by the JAXB provider for performing on-demand
* validation.
*
* The only way for a client application to specify an alternate parser
* mechanism to be used during unmarshal is via the
- * unmarshal(SAXSource) API. All other forms of the unmarshal
+ * {@code unmarshal(SAXSource)} API. All other forms of the unmarshal
* method (File, URL, Node, etc) will use the JAXB provider's default
* parser and validator mechanisms.
*
@@ -623,8 +623,8 @@
* If any unexpected errors occur while unmarshalling
* @throws UnmarshalException
* If the {@link ValidationEventHandler ValidationEventHandler}
- * returns false from its handleEvent method or the
- * Unmarshaller is unable to perform the XML to Java
+ * returns false from its {@code handleEvent} method or the
+ * {@code Unmarshaller} is unable to perform the XML to Java
* binding. See Unmarshalling XML Data
* @throws IllegalArgumentException
* If the Source parameter is null
@@ -635,7 +635,7 @@
/**
- * Unmarshal XML data from the specified XML Source by declaredType and return the
+ * Unmarshal XML data from the specified XML Source by {@code declaredType} and return the
* resulting content tree.
*
*
@@ -647,15 +647,15 @@
* @param source the XML Source to unmarshal XML data from (providers are
* only required to support SAXSource, DOMSource, and StreamSource)
* @param declaredType
- * appropriate JAXB mapped class to hold source 's xml root element
+ * appropriate JAXB mapped class to hold {@code source}'s xml root element
* @return Java content rooted by JAXB Element
*
* @throws JAXBException
* If any unexpected errors occur while unmarshalling
* @throws UnmarshalException
* If the {@link ValidationEventHandler ValidationEventHandler}
- * returns false from its handleEvent method or the
- * Unmarshaller is unable to perform the XML to Java
+ * returns false from its {@code handleEvent} method or the
+ * {@code Unmarshaller} is unable to perform the XML to Java
* binding. See Unmarshalling XML Data
* @throws IllegalArgumentException
* If any parameter is null
@@ -675,7 +675,7 @@
* This method assumes that the parser is on a START_DOCUMENT or
* START_ELEMENT event. Unmarshalling will be done from this
* start event to the corresponding end event. If this method
- * returns successfully, the reader will be pointing at
+ * returns successfully, the {@code reader} will be pointing at
* the token right after the end event.
*
* @param reader
@@ -687,13 +687,13 @@
* If any unexpected errors occur while unmarshalling
* @throws UnmarshalException
* If the {@link ValidationEventHandler ValidationEventHandler}
- * returns false from its handleEvent method or the
- * Unmarshaller is unable to perform the XML to Java
+ * returns false from its {@code handleEvent} method or the
+ * {@code Unmarshaller} is unable to perform the XML to Java
* binding. See Unmarshalling XML Data
* @throws IllegalArgumentException
- * If the reader parameter is null
+ * If the {@code reader} parameter is null
* @throws IllegalStateException
- * If reader is not pointing to a START_DOCUMENT or
+ * If {@code reader} is not pointing to a START_DOCUMENT or
* START_ELEMENT event.
* @since 1.6, JAXB 2.0
* @see #unmarshal(javax.xml.stream.XMLStreamReader, Class)
@@ -702,7 +702,7 @@
throws JAXBException;
/**
- * Unmarshal root element to JAXB mapped declaredType
+ * Unmarshal root element to JAXB mapped {@code declaredType}
* and return the resulting content tree.
*
*
@@ -711,13 +711,13 @@
* This method assumes that the parser is on a START_DOCUMENT or
* START_ELEMENT event. Unmarshalling will be done from this
* start event to the corresponding end event. If this method
- * returns successfully, the reader will be pointing at
+ * returns successfully, the {@code reader} will be pointing at
* the token right after the end event.
*
* @param reader
* The parser to be read.
* @param declaredType
- * appropriate JAXB mapped class to hold reader 's START_ELEMENT XML data.
+ * appropriate JAXB mapped class to hold {@code reader}'s START_ELEMENT XML data.
*
* @return content tree rooted by JAXB Element representation
*
@@ -725,8 +725,8 @@
* If any unexpected errors occur while unmarshalling
* @throws UnmarshalException
* If the {@link ValidationEventHandler ValidationEventHandler}
- * returns false from its handleEvent method or the
- * Unmarshaller is unable to perform the XML to Java
+ * returns false from its {@code handleEvent} method or the
+ * {@code Unmarshaller} is unable to perform the XML to Java
* binding. See Unmarshalling XML Data
* @throws IllegalArgumentException
* If any parameter is null
@@ -745,7 +745,7 @@
* This method assumes that the parser is on a START_DOCUMENT or
* START_ELEMENT event. Unmarshalling will be done from this
* start event to the corresponding end event. If this method
- * returns successfully, the reader will be pointing at
+ * returns successfully, the {@code reader} will be pointing at
* the token right after the end event.
*
* @param reader
@@ -757,13 +757,13 @@
* If any unexpected errors occur while unmarshalling
* @throws UnmarshalException
* If the {@link ValidationEventHandler ValidationEventHandler}
- * returns false from its handleEvent method or the
- * Unmarshaller is unable to perform the XML to Java
+ * returns false from its {@code handleEvent} method or the
+ * {@code Unmarshaller} is unable to perform the XML to Java
* binding. See Unmarshalling XML Data
* @throws IllegalArgumentException
- * If the reader parameter is null
+ * If the {@code reader} parameter is null
* @throws IllegalStateException
- * If reader is not pointing to a START_DOCUMENT or
+ * If {@code reader} is not pointing to a START_DOCUMENT or
* START_ELEMENT event.
* @since 1.6, JAXB 2.0
* @see #unmarshal(javax.xml.stream.XMLEventReader, Class)
@@ -772,7 +772,7 @@
throws JAXBException;
/**
- * Unmarshal root element to JAXB mapped declaredType
+ * Unmarshal root element to JAXB mapped {@code declaredType}
* and return the resulting content tree.
*
*
@@ -782,13 +782,13 @@
* This method assumes that the parser is on a START_DOCUMENT or
* START_ELEMENT event. Unmarshalling will be done from this
* start event to the corresponding end event. If this method
- * returns successfully, the reader will be pointing at
+ * returns successfully, the {@code reader} will be pointing at
* the token right after the end event.
*
* @param reader
* The parser to be read.
* @param declaredType
- * appropriate JAXB mapped class to hold reader 's START_ELEMENT XML data.
+ * appropriate JAXB mapped class to hold {@code reader}'s START_ELEMENT XML data.
*
* @return content tree rooted by JAXB Element representation
*
@@ -796,8 +796,8 @@
* If any unexpected errors occur while unmarshalling
* @throws UnmarshalException
* If the {@link ValidationEventHandler ValidationEventHandler}
- * returns false from its handleEvent method or the
- * Unmarshaller is unable to perform the XML to Java
+ * returns false from its {@code handleEvent} method or the
+ * {@code Unmarshaller} is unable to perform the XML to Java
* binding. See Unmarshalling XML Data
* @throws IllegalArgumentException
* If any parameter is null
@@ -812,9 +812,9 @@
*
* The JAXB Provider can return the same handler object for multiple
* invocations of this method. In other words, this method does not
- * necessarily create a new instance of UnmarshallerHandler . If the
- * application needs to use more than one UnmarshallerHandler , it
- * should create more than one Unmarshaller .
+ * necessarily create a new instance of {@code UnmarshallerHandler}. If the
+ * application needs to use more than one {@code UnmarshallerHandler}, it
+ * should create more than one {@code Unmarshaller}.
*
* @return the unmarshaller handler object
* @see UnmarshallerHandler
@@ -823,8 +823,8 @@
/**
* Specifies whether or not the default validation mechanism of the
- * Unmarshaller should validate during unmarshal operations.
- * By default, the Unmarshaller does not validate.
+ * {@code Unmarshaller} should validate during unmarshal operations.
+ * By default, the {@code Unmarshaller} does not validate.
*
* This method may only be invoked before or after calling one of the
* unmarshal methods.
@@ -852,7 +852,7 @@
throws JAXBException;
/**
- * Indicates whether or not the Unmarshaller is configured to
+ * Indicates whether or not the {@code Unmarshaller} is configured to
* validate during unmarshal operations.
*
* This API returns the state of the JAXB Provider's default unmarshal-time
@@ -874,13 +874,13 @@
throws JAXBException;
/**
- * Allow an application to register a ValidationEventHandler .
+ * Allow an application to register a {@code ValidationEventHandler}.
*
- * The ValidationEventHandler will be called by the JAXB Provider
+ * The {@code ValidationEventHandler} will be called by the JAXB Provider
* if any validation errors are encountered during calls to any of the
* unmarshal methods. If the client application does not register a
- * ValidationEventHandler before invoking the unmarshal methods,
- * then ValidationEvents will be handled by the default event
+ * {@code ValidationEventHandler} before invoking the unmarshal methods,
+ * then {@code ValidationEvents} will be handled by the default event
* handler which will terminate the unmarshal operation after the first
* error or fatal error is encountered.
*
@@ -908,7 +908,7 @@
/**
* Set the particular property in the underlying implementation of
- * Unmarshaller . This method can only be used to set one of
+ * {@code Unmarshaller}. This method can only be used to set one of
* the standard JAXB defined properties above or a provider specific
* property. Attempting to set an undefined property will result in
* a PropertyException being thrown. See
@@ -929,7 +929,7 @@
/**
* Get the particular property in the underlying implementation of
- * Unmarshaller . This method can only be used to get one of
+ * {@code Unmarshaller}. This method can only be used to get one of
* the standard JAXB defined properties above or a provider specific
* property. Attempting to get an undefined property will result in
* a PropertyException being thrown. See
@@ -955,7 +955,7 @@
* API.
*
*
- * Initially this property is set to null .
+ * Initially this property is set to {@code null}.
*
* @param schema Schema object to validate unmarshal operations against or null to disable validation
* @throws UnsupportedOperationException could be thrown if this method is
@@ -976,9 +976,9 @@
* To determine if the Unmarshaller has validation enabled, simply
* test the return type for null:
*
- *
+ * {@code
* boolean isValidating = u.getSchema()!=null;
- *
+ * }
*
* @return the Schema object being used to perform unmarshal-time
* validation or null if not present
@@ -993,7 +993,7 @@
* Associates a configured instance of {@link XmlAdapter} with this unmarshaller.
*
*
- * This is a convenience method that invokes setAdapter(adapter.getClass(),adapter);.
+ * This is a convenience method that invokes {@code setAdapter(adapter.getClass(),adapter);}.
*
* @see #setAdapter(Class,XmlAdapter)
* @throws IllegalArgumentException
@@ -1084,34 +1084,35 @@
public static abstract class Listener {
/**
*
- * Callback method invoked before unmarshalling into target .
+ * Callback method invoked before unmarshalling into {@code target}.
*
*
- * This method is invoked immediately after target was created and
+ * This method is invoked immediately after {@code target} was created and
* before the unmarshalling of this object begins. Note that
- * if the class of target defines its own beforeUnmarshal method,
+ * if the class of {@code target} defines its own {@code beforeUnmarshal} method,
* the class specific callback method is invoked before this method is invoked.
*
* @param target non-null instance of JAXB mapped class prior to unmarshalling into it.
- * @param parent instance of JAXB mapped class that will eventually reference target .
- * null when target is root element.
+ * @param parent instance of JAXB mapped class that will eventually reference {@code target}.
+ * {@code null} when {@code target} is root element.
*/
public void beforeUnmarshal(Object target, Object parent) {
}
/**
*
- * Callback method invoked after unmarshalling XML data into target .
+ * Callback method invoked after unmarshalling XML data into {@code target}.
*
*
- * This method is invoked after all the properties (except IDREF) are unmarshalled into target ,
- * but before target is set into its parent object.
- * Note that if the class of target defines its own afterUnmarshal method,
+ * This method is invoked after all the properties (except IDREF)
+ * are unmarshalled into {@code target},
+ * but before {@code target} is set into its {@code parent} object.
+ * Note that if the class of {@code target} defines its own {@code afterUnmarshal} method,
* the class specific callback method is invoked before this method is invoked.
*
* @param target non-null instance of JAXB mapped class prior to unmarshalling into it.
- * @param parent instance of JAXB mapped class that will reference target .
- * null when target is root element.
+ * @param parent instance of JAXB mapped class that will reference {@code target}.
+ * {@code null} when {@code target} is root element.
*/
public void afterUnmarshal(Object target, Object parent) {
}
@@ -1123,7 +1124,7 @@
*
*
* There is only one Listener per Unmarshaller. Setting a Listener replaces the previous set Listener.
- * One can unregister current Listener by setting listener to null .
+ * One can unregister current Listener by setting listener to {@code null}.
*
* @param listener provides unmarshal event callbacks for this {@link Unmarshaller}
* @since 1.6, JAXB 2.0
@@ -1133,7 +1134,8 @@
/**
*
Return {@link Listener} registered with this {@link Unmarshaller}.
*
- * @return registered {@link Listener} or null if no Listener is registered with this Unmarshaller.
+ * @return registered {@link Listener} or {@code null}
+ * if no Listener is registered with this Unmarshaller.
* @since 1.6, JAXB 2.0
*/
public Listener getListener();
--- old/src/java.xml.bind/share/classes/javax/xml/bind/ValidationEvent.java 2015-09-19 13:15:36.188797987 +0300
+++ new/src/java.xml.bind/share/classes/javax/xml/bind/ValidationEvent.java 2015-09-19 13:15:36.044797273 +0300
@@ -60,8 +60,8 @@
* Retrieve the severity code for this warning/error.
*
*
- * Must be one of ValidationError.WARNING ,
- * ValidationError.ERROR , or ValidationError.FATAL_ERROR .
+ * Must be one of {@code ValidationError.WARNING},
+ * {@code ValidationError.ERROR}, or {@code ValidationError.FATAL_ERROR}.
*
* @return the severity code for this warning/error
*/
--- old/src/java.xml.bind/share/classes/javax/xml/bind/ValidationEventHandler.java 2015-09-19 13:15:36.676800407 +0300
+++ new/src/java.xml.bind/share/classes/javax/xml/bind/ValidationEventHandler.java 2015-09-19 13:15:36.544799753 +0300
@@ -39,7 +39,7 @@
* handlers.
*
*
- * If the handleEvent method throws an unchecked runtime exception,
+ * If the {@code handleEvent} method throws an unchecked runtime exception,
* the JAXB Provider must treat that as if the method returned false, effectively
* terminating whatever operation was in progress at the time (unmarshal,
* validate, or marshal).
@@ -49,7 +49,7 @@
* by the specification and may result in unexpected behaviour.
*
*
- * Failing to return false from the handleEvent method after
+ * Failing to return false from the {@code handleEvent} method after
* encountering a fatal error is undefined by the specification and may result
* in unexpected behavior.
*
@@ -59,7 +59,9 @@
* See: Validator javadocs
*
*
- * @author Ryan Shoemaker, Sun Microsystems, Inc. Kohsuke Kawaguchi, Sun Microsystems, Inc. Joe Fialli, Sun Microsystems, Inc. Ryan Shoemaker, Sun Microsystems, Inc.
+ * Kohsuke Kawaguchi, Sun Microsystems, Inc.
+ * Joe Fialli, Sun Microsystems, Inc. UnmarshalException ,
- * ValidationException , or MarshalException .
+ * operation with the appropriate {@code UnmarshalException},
+ * {@code ValidationException}, or {@code MarshalException}.
* @throws IllegalArgumentException if the event object is null.
*/
public boolean handleEvent( ValidationEvent event );
--- old/src/java.xml.bind/share/classes/javax/xml/bind/ValidationEventLocator.java 2015-09-19 13:15:37.164802827 +0300
+++ new/src/java.xml.bind/share/classes/javax/xml/bind/ValidationEventLocator.java 2015-09-19 13:15:37.028802153 +0300
@@ -29,15 +29,17 @@
* Encapsulate the location of a ValidationEvent.
*
*
- * The ValidationEventLocator indicates where the ValidationEvent
- * occurred. Different fields will be set depending on the type of
+ * The {@code ValidationEventLocator} indicates where the {@code ValidationEvent}
+ * occurred. Different fields will be set depending on the type of
* validation that was being performed when the error or warning was detected.
* For example, on-demand validation would produce locators that contained
* references to objects in the Java content tree while unmarshal-time
* validation would produce locators containing information appropriate to the
* source of the XML data (file, url, Node, etc).
*
- * @author
Ryan Shoemaker, Sun Microsystems, Inc. Kohsuke Kawaguchi, Sun Microsystems, Inc. Joe Fialli, Sun Microsystems, Inc. Ryan Shoemaker, Sun Microsystems, Inc.
+ * Kohsuke Kawaguchi, Sun Microsystems, Inc.
+ * Joe Fialli, Sun Microsystems, Inc.
- * The ValidationEventHandler can cause this exception to be thrown
+ * The {@code ValidationEventHandler} can cause this exception to be thrown
* during the validate operations. See
* {@link ValidationEventHandler#handleEvent(ValidationEvent)
* ValidationEventHandler.handleEvent(ValidationEvent)}.
--- old/src/java.xml.bind/share/classes/javax/xml/bind/Validator.java 2015-09-19 13:15:38.144807687 +0300
+++ new/src/java.xml.bind/share/classes/javax/xml/bind/Validator.java 2015-09-19 13:15:38.000806973 +0300
@@ -28,7 +28,7 @@
/**
* As of JAXB 2.0, this class is deprecated and optional.
*
- * The Validator class is responsible for controlling the validation
+ * The {@code Validator} class is responsible for controlling the validation
* of content trees during runtime.
*
*
@@ -69,19 +69,19 @@
*
*
*
- * The Validator class is responsible for managing On-Demand Validation.
- * The Unmarshaller class is responsible for managing Unmarshal-Time
+ * The {@code Validator} class is responsible for managing On-Demand Validation.
+ * The {@code Unmarshaller} class is responsible for managing Unmarshal-Time
* Validation during the unmarshal operations. Although there is no formal
* method of enabling validation during the marshal operations, the
- * Marshaller may detect errors, which will be reported to the
- * ValidationEventHandler registered on it.
+ * {@code Marshaller} may detect errors, which will be reported to the
+ * {@code ValidationEventHandler} registered on it.
*
*
* Using the Default EventHandler
* If the client application does not set an event handler on their
- * Validator , Unmarshaller , or Marshaller prior to
+ * {@code Validator}, {@code Unmarshaller}, or {@code Marshaller} prior to
* calling the validate, unmarshal, or marshal methods, then a default event
* handler will receive notification of any errors or warnings encountered.
* The default event handler will cause the current operation to halt after
@@ -98,24 +98,24 @@
*
* Use the default event handler
* The default event handler will be used if you do not specify one
- * via the setEventHandler API's on Validator ,
- * Unmarshaller , or Marshaller .
+ * via the {@code setEventHandler} API's on {@code Validator},
+ * {@code Unmarshaller}, or {@code Marshaller}.
*
*
* Implement and register a custom event handler
* Client applications that require sophisticated event processing
- * can implement the ValidationEventHandler interface and
- * register it with the Unmarshaller and/or
- * Validator .
+ * can implement the {@code ValidationEventHandler} interface and
+ * register it with the {@code Unmarshaller} and/or
+ * {@code Validator}.
*
*
* Use the {@link javax.xml.bind.util.ValidationEventCollector ValidationEventCollector}
* utility
* For convenience, a specialized event handler is provided that
- * simply collects any ValidationEvent objects created
+ * simply collects any {@code ValidationEvent} objects created
* during the unmarshal, validate, and marshal operations and
* returns them to the client application as a
- * java.util.Collection .
+ * {@code java.util.Collection}.
*
*
*
@@ -131,9 +131,9 @@
* cases, the JAXB Provider will set the severity of the ValidationEvent to
* FATAL_ERROR to indicate that the unmarshal, validate, or marshal operations
* should be terminated. The default event handler and
- * ValidationEventCollector utility class must terminate processing
+ * {@code ValidationEventCollector} utility class must terminate processing
* after being notified of a fatal error. Client applications that supply their
- * own ValidationEventHandler should also terminate processing after
+ * own {@code ValidationEventHandler} should also terminate processing after
* being notified of a fatal error. If not, unexpected behaviour may occur.
*
*
@@ -195,7 +195,7 @@
throws JAXBException;
/**
- * Validate the Java content tree starting at subrootObj .
+ * Validate the Java content tree starting at {@code subrootObj}.
*
* Client applications can use this method to validate Java content trees
* on-demand at runtime. This method can be used to validate any arbitrary
@@ -206,19 +206,19 @@
* @throws JAXBException if any unexpected problem occurs during validation
* @throws ValidationException
* If the {@link ValidationEventHandler ValidationEventHandler}
- * returns false from its handleEvent method or the
- * Validator is unable to validate the content tree rooted
- * at subrootObj
+ * returns false from its {@code handleEvent} method or the
+ * {@code Validator} is unable to validate the content tree rooted
+ * at {@code subrootObj}
* @throws IllegalArgumentException
* If the subrootObj parameter is null
- * @return true if the subtree rooted at subrootObj is valid, false
+ * @return true if the subtree rooted at {@code subrootObj} is valid, false
* otherwise
* @deprecated since JAXB2.0
*/
public boolean validate( Object subrootObj ) throws JAXBException;
/**
- * Validate the Java content tree rooted at rootObj .
+ * Validate the Java content tree rooted at {@code rootObj}.
*
* Client applications can use this method to validate Java content trees
* on-demand at runtime. This method is used to validate an entire Java
@@ -229,12 +229,12 @@
* @throws JAXBException if any unexpected problem occurs during validation
* @throws ValidationException
* If the {@link ValidationEventHandler ValidationEventHandler}
- * returns false from its handleEvent method or the
- * Validator is unable to validate the content tree rooted
- * at rootObj
+ * returns false from its {@code handleEvent} method or the
+ * {@code Validator} is unable to validate the content tree rooted
+ * at {@code rootObj}
* @throws IllegalArgumentException
* If the rootObj parameter is null
- * @return true if the tree rooted at rootObj is valid, false
+ * @return true if the tree rooted at {@code rootObj} is valid, false
* otherwise
* @deprecated since JAXB2.0
*/
@@ -242,7 +242,7 @@
/**
* Set the particular property in the underlying implementation of
- * Validator . This method can only be used to set one of
+ * {@code Validator}. This method can only be used to set one of
* the standard JAXB defined properties above or a provider specific
* property. Attempting to set an undefined property will result in
* a PropertyException being thrown. See
@@ -264,7 +264,7 @@
/**
* Get the particular property in the underlying implementation of
- * Validator . This method can only be used to get one of
+ * {@code Validator}. This method can only be used to get one of
* the standard JAXB defined properties above or a provider specific
* property. Attempting to get an undefined property will result in
* a PropertyException being thrown. See
--- old/src/java.xml.bind/share/classes/javax/xml/bind/annotation/XmlAccessorOrder.java 2015-09-19 13:15:38.644810166 +0300
+++ new/src/java.xml.bind/share/classes/javax/xml/bind/annotation/XmlAccessorOrder.java 2015-09-19 13:15:38.504809472 +0300
@@ -38,7 +38,7 @@
*
* Usage
*
- * @XmlAccessorOrder annotation can be used with the following
+ *
{@code @XmlAccessorOrder} annotation can be used with the following
* program elements:
*
*
@@ -46,19 +46,19 @@
* a top level class
*
*
- * See "Package Specification" in javax.xml.bind package javadoc for
+ *
See "Package Specification" in {@code javax.xml.bind} package javadoc for
* additional common information.
*
* The effective {@link XmlAccessOrder} on a class is determined
* as follows:
*
*
- * If there is a @XmlAccessorOrder on a class, then
+ * If there is a {@code @XmlAccessorOrder} on a class, then
* it is used.
- * Otherwise, if a @XmlAccessorOrder exists on one of
+ * Otherwise, if a {@code @XmlAccessorOrder} exists on one of
* its super classes, then it is inherited (by the virtue of
* {@link Inherited})
- * Otherwise, the @XmlAccessorOrder on the package
+ * Otherwise, the {@code @XmlAccessorOrder} on the package
* of the class is used, if it's there.
* Otherwise {@link XmlAccessOrder#UNDEFINED}.
*
--- old/src/java.xml.bind/share/classes/javax/xml/bind/annotation/XmlAccessorType.java 2015-09-19 13:15:39.132812586 +0300
+++ new/src/java.xml.bind/share/classes/javax/xml/bind/annotation/XmlAccessorType.java 2015-09-19 13:15:38.996811912 +0300
@@ -38,7 +38,7 @@
*
* Usage
*
- * @XmlAccessorType annotation can be used with the following program elements:
+ * {@code @XmlAccessorType} annotation can be used with the following program elements:
*
*
* package
@@ -51,28 +51,28 @@
* This annotation provides control over the default serialization
* of properties and fields in a class.
*
- *
The annotation @XmlAccessorType on a package applies to
+ *
The annotation {@code @XmlAccessorType} on a package applies to
* all classes in the package. The following inheritance
* semantics apply:
*
*
- * If there is a @XmlAccessorType on a class, then it
+ * If there is a {@code @XmlAccessorType} on a class, then it
* is used.
- * Otherwise, if a @XmlAccessorType exists on one of
+ * Otherwise, if a {@code @XmlAccessorType} exists on one of
* its super classes, then it is inherited.
- * Otherwise, the @XmlAccessorType on a package is
+ * Otherwise, the {@code @XmlAccessorType} on a package is
* inherited.
*
* Defaulting Rules:
*
- * By default, if @XmlAccessorType on a package is absent,
+ *
By default, if {@code @XmlAccessorType} on a package is absent,
* then the following package level annotation is assumed.
*
* @XmlAccessorType(XmlAccessType.PUBLIC_MEMBER)
*
- * By default, if @XmlAccessorType on a class is absent,
+ *
By default, if {@code @XmlAccessorType} on a class is absent,
* and none of its super classes is annotated with
- * @XmlAccessorType , then the following default on the class
+ * {@code @XmlAccessorType}, then the following default on the class
* is assumed:
*
* @XmlAccessorType(XmlAccessType.PUBLIC_MEMBER)
--- old/src/java.xml.bind/share/classes/javax/xml/bind/annotation/XmlAnyAttribute.java 2015-09-19 13:15:39.624815026 +0300
+++ new/src/java.xml.bind/share/classes/javax/xml/bind/annotation/XmlAnyAttribute.java 2015-09-19 13:15:39.488814351 +0300
@@ -40,7 +40,7 @@
*
* Usage
*
- * The @XmlAnyAttribute annotation can be used with the
+ * The {@code @XmlAnyAttribute} annotation can be used with the
* following program elements:
*
* JavaBean property
@@ -53,8 +53,8 @@
* The usage is subject to the following constraints:
*
* At most one field or property in a class can be annotated
- * with @XmlAnyAttribute .
- * The type of the property or the field must java.util.Map
+ * with {@code @XmlAnyAttribute}.
+ * The type of the property or the field must {@code java.util.Map}
*
*
*
--- old/src/java.xml.bind/share/classes/javax/xml/bind/annotation/XmlAttribute.java 2015-09-19 13:15:40.112817446 +0300
+++ new/src/java.xml.bind/share/classes/javax/xml/bind/annotation/XmlAttribute.java 2015-09-19 13:15:39.976816771 +0300
@@ -37,7 +37,7 @@
*
*
Usage
*
- * The @XmlAttribute annotation can be used with the
+ * The {@code @XmlAttribute} annotation can be used with the
* following program elements:
*
* JavaBean property
--- old/src/java.xml.bind/share/classes/javax/xml/bind/annotation/XmlElement.java 2015-09-19 13:15:40.612819925 +0300
+++ new/src/java.xml.bind/share/classes/javax/xml/bind/annotation/XmlElement.java 2015-09-19 13:15:40.472819231 +0300
@@ -38,7 +38,7 @@
*
* Usage
*
- * @XmlElement annotation can be used with the following program
+ * {@code @XmlElement} annotation can be used with the following program
* elements:
*
* a JavaBean property
@@ -62,7 +62,7 @@
* if the type of JavaBean property is a collection type of
* array, an indexed property, or a parameterized list, and
* this annotation is used with {@link XmlElements} then,
- * @XmlElement.type() must be DEFAULT.class since the
+ * {@code @XmlElement.type()} must be DEFAULT.class since the
* collection item type is already known.
*
*
--- old/src/java.xml.bind/share/classes/javax/xml/bind/annotation/XmlElementDecl.java 2015-09-19 13:15:41.112822404 +0300
+++ new/src/java.xml.bind/share/classes/javax/xml/bind/annotation/XmlElementDecl.java 2015-09-19 13:15:40.968821690 +0300
@@ -170,19 +170,19 @@
* namespace name of a substitution group's head XML element.
*
* This specifies the namespace name of the XML element whose local
- * name is specified by substitutionHeadName() .
+ * name is specified by {@code substitutionHeadName()}.
*
- * If susbtitutionHeadName() is "", then this
+ * If {@code susbtitutionHeadName()} is "", then this
* value can only be "##default". But the value is ignored since
* since this element is not part of susbtitution group when the
- * value of susbstitutionHeadName() is "".
+ * value of {@code susbstitutionHeadName()} is "".
*
- * If susbtitutionHeadName() is not "" and the value is
+ * If {@code susbtitutionHeadName()} is not "" and the value is
* "##default", then the namespace name is the namespace name to
* which the package of the containing class, marked with {@link
* XmlRegistry }, is mapped.
*
- * If susbtitutionHeadName() is not "" and the value is
+ * If {@code susbtitutionHeadName()} is not "" and the value is
* not "##default", then the value is the namespace name.
*
* @see #substitutionHeadName()
--- old/src/java.xml.bind/share/classes/javax/xml/bind/annotation/XmlElementRef.java 2015-09-19 13:15:41.612824884 +0300
+++ new/src/java.xml.bind/share/classes/javax/xml/bind/annotation/XmlElementRef.java 2015-09-19 13:15:41.472824189 +0300
@@ -39,7 +39,7 @@
*
* Usage
*
- * @XmlElementRef annotation can be used with a
+ * {@code @XmlElementRef} annotation can be used with a
* JavaBean property or from within {@link XmlElementRefs}
*
* This annotation dynamically associates an XML element name with the JavaBean
@@ -62,9 +62,9 @@
* }
*
* An element factory method annotated with {@link XmlElementDecl} is
- * used to create a JAXBElement instance, containing an XML
- * element name. The presence of @XmlElementRef annotation on an
- * element property indicates that the element name from JAXBElement
+ * used to create a {@code JAXBElement} instance, containing an XML
+ * element name. The presence of {@code @XmlElementRef} annotation on an
+ * element property indicates that the element name from {@code JAXBElement}
* instance be used instead of deriving an XML element name from the
* JavaBean property name.
*
@@ -74,7 +74,7 @@
*
If the collection item type (for collection property) or
* property type (for single valued property) is
* {@link javax.xml.bind.JAXBElement}, then
- * @XmlElementRef}.name() and @XmlElementRef.namespace() must
+ * {@code @XmlElementRef.name()} and {@code @XmlElementRef.namespace()} must
* point an element factory method with an @XmlElementDecl
* annotation in a class annotated with @XmlRegistry (usually
* ObjectFactory class generated by the schema compiler) :
@@ -155,7 +155,7 @@
*
* }
*
- * It is not an error to have a class that extends Task
+ * It is not an error to have a class that extends {@code Task}
* that doesn't have {@link XmlRootElement}. But they can't show up in an
* XML instance (because they don't have XML element names).
*
@@ -234,8 +234,8 @@
* This parameter and {@link #name()} are used to determine the
* XML element for the JavaBean property.
*
- *
If type() is JAXBElement.class , then
- * namespace() and name()
+ *
If {@code type()} is {@code JAXBElement.class} , then
+ * {@code namespace()} and {@code name()}
* point to a factory method with {@link XmlElementDecl}. The XML
* element name is the element name from the factory method's
* {@link XmlElementDecl} annotation or if an element from its
@@ -243,13 +243,13 @@
* substituted in the XML document, then the element name is from the
* {@link XmlElementDecl} on the substituted element.
*
- *
If {@link #type()} is not JAXBElement.class , then
+ *
If {@link #type()} is not {@code JAXBElement.class}, then
* the XML element name is the XML element name statically
* associated with the type using the annotation {@link
* XmlRootElement} on the type. If the type is not annotated with
* an {@link XmlElementDecl}, then it is an error.
*
- *
If type() is not JAXBElement.class , then
+ *
If {@code type()} is not {@code JAXBElement.class}, then
* this value must be "".
*
*/
@@ -282,7 +282,7 @@
* for a multivalued property.
*
*
- * For compatibility with JAXB 2.1, this property defaults to true ,
+ * For compatibility with JAXB 2.1, this property defaults to {@code true},
* despite the fact that {@link XmlElement#required()} defaults to false.
*
* @since 1.7, JAXB 2.2
--- old/src/java.xml.bind/share/classes/javax/xml/bind/annotation/XmlElementWrapper.java 2015-09-19 13:15:42.132827462 +0300
+++ new/src/java.xml.bind/share/classes/javax/xml/bind/annotation/XmlElementWrapper.java 2015-09-19 13:15:41.968826649 +0300
@@ -61,7 +61,7 @@
*
*
Usage
*
- * The @XmlElementWrapper annotation can be used with the
+ * The {@code @XmlElementWrapper} annotation can be used with the
* following program elements:
*
* JavaBean property
@@ -120,7 +120,7 @@
/**
* If true, the absence of the collection is represented by
- * using xsi:nil='true' . Otherwise, it is represented by
+ * using {@code xsi:nil='true'}. Otherwise, it is represented by
* the absence of the element.
*/
boolean nillable() default false;
@@ -130,7 +130,7 @@
*
*
* If required() is true, then the corresponding generated
- * XML schema element declaration will have minOccurs="1" ,
+ * XML schema element declaration will have {@code minOccurs="1"},
* to indicate that the wrapper element is always expected.
*
*
--- old/src/java.xml.bind/share/classes/javax/xml/bind/annotation/XmlElements.java 2015-09-19 13:15:42.636829961 +0300
+++ new/src/java.xml.bind/share/classes/javax/xml/bind/annotation/XmlElements.java 2015-09-19 13:15:42.492829247 +0300
@@ -44,7 +44,7 @@
* @XmlElements({ @XmlElement(...),@XmlElement(...) })
*
*
- *
The @XmlElements annotation can be used with the
+ *
The {@code @XmlElements} annotation can be used with the
* following program elements:
*
* a JavaBean property
@@ -62,7 +62,7 @@
* annotations: @{@link XmlIDREF}, @{@link XmlElementWrapper}.
* If @XmlIDREF is also specified on the JavaBean property,
* then each @XmlElement.type() must contain a JavaBean
- * property annotated with @XmlID .
+ * property annotated with {@code @XmlID}.
*
*
* See "Package Specification" in javax.xml.bind.package javadoc for
--- old/src/java.xml.bind/share/classes/javax/xml/bind/annotation/XmlEnum.java 2015-09-19 13:15:43.124832381 +0300
+++ new/src/java.xml.bind/share/classes/javax/xml/bind/annotation/XmlEnum.java 2015-09-19 13:15:42.988831707 +0300
@@ -39,7 +39,7 @@
*
*
Usage
*
- * The @XmlEnum annotation can be used with the
+ * The {@code @XmlEnum} annotation can be used with the
* following program elements:
*
* enum type
@@ -56,9 +56,9 @@
*
* An enum type is mapped to a schema simple type with enumeration
* facets. The schema type is derived from the Java type to which
- * @XmlEnum.value() . Each enum constant @XmlEnumValue
+ * {@code @XmlEnum.value()}. Each enum constant {@code @XmlEnumValue}
* must have a valid lexical representation for the type
- * @XmlEnum.value() .
+ * {@code @XmlEnum.value()}.
*
*
Examples: See examples in {@link XmlEnumValue}
*
--- old/src/java.xml.bind/share/classes/javax/xml/bind/annotation/XmlEnumValue.java 2015-09-19 13:15:43.612834801 +0300
+++ new/src/java.xml.bind/share/classes/javax/xml/bind/annotation/XmlEnumValue.java 2015-09-19 13:15:43.476834127 +0300
@@ -35,7 +35,7 @@
*
*
Usage
*
- * The @XmlEnumValue annotation can be used with the
+ *
The {@code @XmlEnumValue} annotation can be used with the
* following program elements:
*
* enum constant
@@ -49,9 +49,9 @@
*
* An enum type is mapped to a schema simple type with enumeration
* facets. The schema type is derived from the Java type specified in
- * @XmlEnum.value() . Each enum constant @XmlEnumValue
+ * {@code @XmlEnum.value()}. Each enum constant {@code @XmlEnumValue}
* must have a valid lexical representation for the type
- * @XmlEnum.value()
+ * {@code @XmlEnum.value()}
*
*
In the absence of this annotation, {@link Enum#name()} is used
* as the XML representation.
--- old/src/java.xml.bind/share/classes/javax/xml/bind/annotation/XmlID.java 2015-09-19 13:15:44.100837221 +0300
+++ new/src/java.xml.bind/share/classes/javax/xml/bind/annotation/XmlID.java 2015-09-19 13:15:43.964836547 +0300
@@ -38,12 +38,12 @@
* To preserve referential integrity of an object graph across XML
* serialization followed by a XML deserialization, requires an object
* reference to be marshalled by reference or containment
- * appropriately. Annotations @XmlID and @XmlIDREF
+ * appropriately. Annotations {@code @XmlID} and {@code @XmlIDREF}
* together allow a customized mapping of a JavaBean property's
* type by containment or reference.
*
*
Usage
- * The @XmlID annotation can be used with the following
+ * The {@code @XmlID} annotation can be used with the following
* program elements:
*
* a JavaBean property
@@ -56,14 +56,14 @@
* The usage is subject to the following constraints:
*
* At most one field or property in a class can be annotated
- * with @XmlID .
- * The JavaBean property's type must be java.lang.String .
+ * with {@code @XmlID}.
+ * The JavaBean property's type must be {@code java.lang.String}.
* The only other mapping annotations that can be used
- * with @XmlID
- * are:@XmlElement and @XmlAttribute .
+ * with {@code @XmlID}
+ * are: {@code @XmlElement} and {@code @XmlAttribute}.
*
*
- * Example : Map a JavaBean property's type to xs:ID
+ * Example : Map a JavaBean property's type to {@code xs:ID}
*
* // Example: code fragment
* public class Customer {
--- old/src/java.xml.bind/share/classes/javax/xml/bind/annotation/XmlIDREF.java 2015-09-19 13:15:44.600839700 +0300
+++ new/src/java.xml.bind/share/classes/javax/xml/bind/annotation/XmlIDREF.java 2015-09-19 13:15:44.468839046 +0300
@@ -38,12 +38,12 @@
* To preserve referential integrity of an object graph across XML
* serialization followed by a XML deserialization, requires an object
* reference to be marshaled by reference or containment
- * appropriately. Annotations @XmlID and @XmlIDREF
+ * appropriately. Annotations {@code @XmlID} and {@code @XmlIDREF}
* together allow a customized mapping of a JavaBean property's
* type by containment or reference.
*
* Usage
- * The @XmlIDREF annotation can be used with the following
+ * The {@code @XmlIDREF} annotation can be used with the following
* program elements:
*
- * Example: Map a JavaBean property to xs:IDREF
+ *
Example: Map a JavaBean property to {@code xs:IDREF}
* (i.e. by reference rather than by containment)
*
*
@@ -101,10 +101,10 @@
* containment versus reference.
*
*
- * // By default, Customer maps to complex type xs:Customer
+ * // By default, Customer maps to complex type {@code xs:Customer}
* public class Customer {
*
- * // map JavaBean property type to xs:ID
+ * // map JavaBean property type to {@code xs:ID}
* @XmlID public String getCustomerID();
* public void setCustomerID(String id);
*
@@ -112,7 +112,7 @@
* }
*
*
- * // By default, Invoice maps to a complex type xs:Invoice
+ * // By default, Invoice maps to a complex type {@code xs:Invoice}
* public class Invoice {
*
* // map by reference
@@ -122,7 +122,7 @@
* // .... other properties not shown here
* }
*
- * // By default, Shipping maps to complex type xs:Shipping
+ * // By default, Shipping maps to complex type {@code xs:Shipping}
* public class Shipping {
*
* // map by reference
--- old/src/java.xml.bind/share/classes/javax/xml/bind/annotation/XmlInlineBinaryData.java 2015-09-19 13:15:45.112842239 +0300
+++ new/src/java.xml.bind/share/classes/javax/xml/bind/annotation/XmlInlineBinaryData.java 2015-09-19 13:15:44.964841505 +0300
@@ -41,7 +41,9 @@
* base64-encoded binary data in XML.
*
*
- * When XOP encoding is enabled as described in {@link AttachmentMarshaller#isXOPPackage()}, this annotation disables datatypes such as {@link java.awt.Image} or {@link Source} or byte[] that are bound to base64-encoded binary from being considered for
+ * When XOP encoding is enabled as described in {@link AttachmentMarshaller#isXOPPackage()},
+ * this annotation disables datatypes such as {@link java.awt.Image} or {@link Source}
+ * or {@code byte[]} that are bound to base64-encoded binary from being considered for
* XOP encoding. If a JAXB property is annotated with this annotation or if
* the JAXB property's base type is annotated with this annotation,
* neither
--- old/src/java.xml.bind/share/classes/javax/xml/bind/annotation/XmlList.java 2015-09-19 13:15:45.612844719 +0300
+++ new/src/java.xml.bind/share/classes/javax/xml/bind/annotation/XmlList.java 2015-09-19 13:15:45.472844025 +0300
@@ -37,7 +37,7 @@
*
*
Usage
*
- * The @XmlList annotation can be used with the
+ * The {@code @XmlList} annotation can be used with the
* following program elements:
*
* JavaBean property
@@ -92,12 +92,12 @@
* {@link XmlValue},
* {@link XmlIDREF}.
*
- * The use of @XmlList with {@link XmlValue} while
+ * The use of {@code @XmlList} with {@link XmlValue} while
* allowed, is redundant since {@link XmlList} maps a
* collection type to a simple schema type that derives by
* list just as {@link XmlValue} would.
*
- * The use of @XmlList with {@link XmlAttribute} while
+ * The use of {@code @XmlList} with {@link XmlAttribute} while
* allowed, is redundant since {@link XmlList} maps a
* collection type to a simple schema type that derives by
* list just as {@link XmlAttribute} would.
--- old/src/java.xml.bind/share/classes/javax/xml/bind/annotation/XmlNs.java 2015-09-19 13:15:46.104847158 +0300
+++ new/src/java.xml.bind/share/classes/javax/xml/bind/annotation/XmlNs.java 2015-09-19 13:15:45.964846464 +0300
@@ -34,13 +34,13 @@
* Associates a namespace prefix with a XML namespace URI.
*
* Usage
- * @XmlNs annotation is intended for use from other
+ *
{@code @XmlNs} annotation is intended for use from other
* program annotations.
*
*
See "Package Specification" in javax.xml.bind.package javadoc for
* additional common information.
*
- * Example: See XmlSchema annotation type for an example.
+ *
Example: See {@code XmlSchema} annotation type for an example.
* @author Sekhar Vajjhala, Sun Microsystems, Inc.
* @since 1.6, JAXB 2.0
*/
--- old/src/java.xml.bind/share/classes/javax/xml/bind/annotation/XmlSchema.java 2015-09-19 13:15:46.592849578 +0300
+++ new/src/java.xml.bind/share/classes/javax/xml/bind/annotation/XmlSchema.java 2015-09-19 13:15:46.456848904 +0300
@@ -163,12 +163,12 @@
* manually.
*
*
- * Value could be any absolute URI, like http://example.org/some.xsd .
+ * Value could be any absolute URI, like {@code http://example.org/some.xsd}.
* It is also possible to specify the empty string, to indicate
* that the schema is externally available but the location is
* unspecified (and thus it's the responsibility of the reader of the generate
* schema to locate it.) Finally, the default value of this property
- * "##generate" indicates that the schema generator is going
+ * {@code "##generate"} indicates that the schema generator is going
* to generate components for this namespace (as it did in JAXB 2.0.)
*
*
@@ -179,17 +179,17 @@
*
*
Note to implementor
*
- * More precisely, the value must be either "" , "##generate" , or
+ * More precisely, the value must be either {@code ""}, {@code "##generate"}, or
*
- * a valid lexical representation of xs:anyURI that begins
- * with <scheme>: .
+ * a valid lexical representation of {@code xs:anyURI} that begins
+ * with {@code :}.
*
*
* A schema generator is expected to generate a corresponding
- * <xs:import namespace="..." schemaLocation="..."/> (or
- * no schemaLocation attribute at all if the empty string is specified.)
+ * {@code schemaLocation attribute (including not generating
+ * the {@code schemaLocation} attribute (including not generating
* such attribute), for example so that the user can specify a local
* copy of the resource through the command line interface.
*
--- old/src/java.xml.bind/share/classes/javax/xml/bind/annotation/XmlSchemaType.java 2015-09-19 13:15:47.092852058 +0300
+++ new/src/java.xml.bind/share/classes/javax/xml/bind/annotation/XmlSchemaType.java 2015-09-19 13:15:46.948851344 +0300
@@ -38,7 +38,7 @@
*
*
Usage
*
- * @XmlSchemaType annotation can be used with the following program
+ * {@code @XmlSchemaType} annotation can be used with the following program
* elements:
*
* a JavaBean property
@@ -46,10 +46,10 @@
* package
*
*
- * @XmlSchemaType annotation defined for Java type
+ *
{@code @XmlSchemaType} annotation defined for Java type
* applies to all references to the Java type from a property/field.
- * A @XmlSchemaType annotation specified on the
- * property/field overrides the @XmlSchemaType annotation
+ * A {@code @XmlSchemaType} annotation specified on the
+ * property/field overrides the {@code @XmlSchemaType} annotation
* specified at the package level.
*
*
This annotation can be used with the following annotations:
--- old/src/java.xml.bind/share/classes/javax/xml/bind/annotation/XmlSchemaTypes.java 2015-09-19 13:15:47.592854537 +0300
+++ new/src/java.xml.bind/share/classes/javax/xml/bind/annotation/XmlSchemaTypes.java 2015-09-19 13:15:47.448853823 +0300
@@ -41,7 +41,7 @@
*
* @XmlSchemaTypes({ @XmlSchemaType(...), @XmlSchemaType(...) })
*
- * The @XmlSchemaTypes annnotation can be used to
+ *
The {@code @XmlSchemaTypes} annnotation can be used to
* define {@link XmlSchemaType} for different types at the
* package level.
*
--- old/src/java.xml.bind/share/classes/javax/xml/bind/annotation/XmlSeeAlso.java 2015-09-19 13:15:48.080856957 +0300
+++ new/src/java.xml.bind/share/classes/javax/xml/bind/annotation/XmlSeeAlso.java 2015-09-19 13:15:47.944856283 +0300
@@ -51,9 +51,9 @@
*
*
* The user would be required to create {@link JAXBContext} as
- * JAXBContext.newInstance(Dog.class,Cat.class)
- * (Animal will be automatically picked up since Dog
- * and Cat refers to it.)
+ * {@code JAXBContext.newInstance(Dog.class,Cat.class)}
+ * ({@code Animal} will be automatically picked up since {@code Dog}
+ * and {@code Cat} refers to it.)
*
*
* {@link XmlSeeAlso} annotation would allow you to write:
@@ -65,9 +65,9 @@
*
*
*
- * This would allow you to do JAXBContext.newInstance(Animal.class) .
+ * This would allow you to do {@code JAXBContext.newInstance(Animal.class)}.
* By the help of this annotation, JAXB implementations will be able to
- * correctly bind Dog and Cat .
+ * correctly bind {@code Dog} and {@code Cat}.
*
* @author Kohsuke Kawaguchi
* @since 1.6, JAXB 2.1
--- old/src/java.xml.bind/share/classes/javax/xml/bind/annotation/XmlTransient.java 2015-09-19 13:15:48.568859377 +0300
+++ new/src/java.xml.bind/share/classes/javax/xml/bind/annotation/XmlTransient.java 2015-09-19 13:15:48.436858722 +0300
@@ -34,14 +34,14 @@
*
* Prevents the mapping of a JavaBean property/type to XML representation.
*
- * The @XmlTransient annotation is useful for resolving name
+ * The {@code @XmlTransient} annotation is useful for resolving name
* collisions between a JavaBean property name and a field name or
* preventing the mapping of a field/property. A name collision can
* occur when the decapitalized JavaBean property name and a field
* name are the same. If the JavaBean property refers to the field,
* then the name collision can be resolved by preventing the
* mapping of either the field or the JavaBean property using the
- * @XmlTransient annotation.
+ * {@code @XmlTransient} annotation.
*
*
* When placed on a class, it indicates that the class shouldn't be mapped
@@ -49,7 +49,7 @@
* with its derived classes, as if the class is inlined.
*
*
Usage
- * The @XmlTransient annotation can be used with the following
+ *
The {@code @XmlTransient} annotation can be used with the following
* program elements:
*
* a JavaBean property
@@ -57,7 +57,7 @@
* class
*
*
- * @XmlTransient is mutually exclusive with all other
+ *
{@code @XmlTransient} is mutually exclusive with all other
* JAXB defined annotations.
*
* See "Package Specification" in javax.xml.bind.package javadoc for
--- old/src/java.xml.bind/share/classes/javax/xml/bind/annotation/XmlType.java 2015-09-19 13:15:49.060861817 +0300
+++ new/src/java.xml.bind/share/classes/javax/xml/bind/annotation/XmlType.java 2015-09-19 13:15:48.924861142 +0300
@@ -35,7 +35,7 @@
* Maps a class or an enum type to a XML Schema type.
*
*
Usage
- * The @XmlType annnotation can be used with the following program
+ *
The {@code @XmlType} annnotation can be used with the following program
* elements:
*
* a top level class
@@ -53,8 +53,8 @@
* schema type's content model (e.g. model groups, attributes etc).
* To be mapped, a class must either have a public no-arg
* constructor or a static no-arg factory method. The static factory
- * method can be specified in factoryMethod() and
- * factoryClass() annotation elements. The static factory
+ * method can be specified in {@code factoryMethod()} and
+ * {@code factoryClass()} annotation elements. The static factory
* method or the no-arg constructor is used during unmarshalling to
* create an instance of this class. If both are present, the static
* factory method overrides the no-arg constructor.
@@ -64,7 +64,7 @@
* mapping of JavaBean properties and fields contained within the
* class. The schema type to which the class is mapped can either be
* named or anonymous. A class can be mapped to an anonymous schema
- * type by annotating the class with @XmlType(name="") .
+ * type by annotating the class with {@code @XmlType(name="")}.
*
* Either a global element, local element or a local attribute can be
* associated with an anonymous type as follows:
@@ -84,29 +84,29 @@
*
* Mapping to XML Schema Complex Type
*
- * If class is annotated with @XmlType(name="") , it
+ * If class is annotated with {@code @XmlType(name="") }, it
* is mapped to an anonymous type otherwise, the class name maps
- * to a complex type name. The XmlName() annotation element
+ * to a complex type name. The {@code XmlName()} annotation element
* can be used to customize the name.
*
* Properties and fields that are mapped to elements are mapped to a
* content model within a complex type. The annotation element
- * propOrder() can be used to customize the content model to be
- * xs:all or xs:sequence . It is used for specifying
- * the order of XML elements in xs:sequence .
+ * {@code propOrder()} can be used to customize the content model to be
+ * {@code xs:all} or {@code xs:sequence}. It is used for specifying
+ * the order of XML elements in {@code xs:sequence}.
*
* Properties and fields can be mapped to attributes within the
* complex type.
*
* The targetnamespace of the XML Schema type can be customized
- * using the annotation element namespace() .
+ * using the annotation element {@code namespace()}.
*
*
*
* Mapping class to XML Schema simple type
*
* A class can be mapped to a XML Schema simple type using the
- * @XmlValue annotation. For additional details and examples,
+ * {@code @XmlValue} annotation. For additional details and examples,
* see @{@link XmlValue} annotation type.
*
* The following table shows the mapping of the class to a XML Schema
@@ -114,8 +114,8 @@
*
* {@literal ->} : represents a mapping
* [x]+ : one or more occurances of x
- * [ @XmlValue property ]: JavaBean property annotated with
- * @XmlValue
+ * [ {@code @XmlValue} property ]: JavaBean property annotated with
+ * {@code @XmlValue}
* X : don't care
*
*
@@ -156,7 +156,7 @@
*
* Class
* X
- * 1 [@XmlValue property] {@literal &&}
+ * 1 [{@code @XmlValue} property] {@literal &&}
* simplecontent
*
*
@@ -164,7 +164,7 @@
*
* Class
* X
- * 1 [@XmlValue property] {@literal &&}
+ * 1 [{@code @XmlValue} property] {@literal &&}
*
* simpletype
*
@@ -176,8 +176,8 @@
*
* An enum type maps to a XML schema simple type with enumeration
* facets. The following annotation elements are ignored since they
- * are not meaningful: propOrder() , factoryMethod() ,
- * factoryClass() .
+ * are not meaningful: {@code propOrder()} , {@code factoryMethod()} ,
+ * {@code factoryClass()} .
*
* Usage with other annotations
* This annotation can be used with the following annotations:
@@ -406,7 +406,7 @@
*
All of the JavaBean properties being mapped to XML Schema elements
* must be listed.
*
A JavaBean property or field listed in propOrder must not
- * be transient or annotated with @XmlTransient .
+ * be transient or annotated with {@code @XmlTransient}.
*
The default ordering of JavaBean properties is determined
* by @{@link XmlAccessorOrder}.
*/
@@ -423,18 +423,18 @@
* Class containing a no-arg factory method for creating an
* instance of this class. The default is this class.
*
- *
If factoryClass is DEFAULT.class and
- * factoryMethod is "", then there is no static factory
+ *
If {@code factoryClass} is DEFAULT.class and
+ * {@code factoryMethod} is "", then there is no static factory
* method.
*
- *
If factoryClass is DEFAULT.class and
- * factoryMethod is not "", then
- * factoryMethod is the name of a static factory method
+ *
If {@code factoryClass} is DEFAULT.class and
+ * {@code factoryMethod} is not "", then
+ * {@code factoryMethod} is the name of a static factory method
* in this class.
*
- *
If factoryClass is not DEFAULT.class, then
- * factoryMethod must not be "" and must be the name of
- * a static factory method specified in factoryClass .
+ *
If {@code factoryClass} is not DEFAULT.class, then
+ * {@code factoryMethod} must not be "" and must be the name of
+ * a static factory method specified in {@code factoryClass}.
*/
Class factoryClass() default DEFAULT.class;
@@ -447,7 +447,7 @@
/**
* Name of a no-arg factory method in the class specified in
- * factoryClass factoryClass().
+ * {@code factoryClass} factoryClass().
*
*/
String factoryMethod() default "";
--- old/src/java.xml.bind/share/classes/javax/xml/bind/annotation/XmlValue.java 2015-09-19 13:15:49.572864355 +0300
+++ new/src/java.xml.bind/share/classes/javax/xml/bind/annotation/XmlValue.java 2015-09-19 13:15:49.424863622 +0300
@@ -39,7 +39,7 @@
*
* Usage:
*
- * The @XmlValue annotation can be used with the following program
+ * The {@code @XmlValue} annotation can be used with the following program
* elements:
*
* a JavaBean property.
@@ -52,9 +52,9 @@
* The usage is subject to the following usage constraints:
*
* At most one field or property can be annotated with the
- * @XmlValue annotation.
+ * {@code @XmlValue} annotation.
*
- * @XmlValue can be used with the following
+ * {@code @XmlValue} can be used with the following
* annotations: {@link XmlList}. However this is redundant since
* {@link XmlList} maps a type to a simple schema type that derives by
* list just as {@link XmlValue} would.
@@ -73,7 +73,7 @@
* simple type.
*
* If there are additional JavaBean properties (other than the
- * JavaBean property annotated with @XmlValue annotation)
+ * JavaBean property annotated with {@code @XmlValue} annotation)
* that are mapped to XML attributes, then the class is mapped to a
* complex type with simpleContent.
*
--- old/src/java.xml.bind/share/classes/javax/xml/bind/annotation/adapters/CollapsedStringAdapter.java 2015-09-19 13:15:50.072866835 +0300
+++ new/src/java.xml.bind/share/classes/javax/xml/bind/annotation/adapters/CollapsedStringAdapter.java 2015-09-19 13:15:49.924866101 +0300
@@ -28,7 +28,7 @@
/**
- * Built-in {@link XmlAdapter} to handle xs:token and its derived types.
+ * Built-in {@link XmlAdapter} to handle {@code xs:token} and its derived types.
*
*
* This adapter removes leading and trailing whitespaces, then truncate any
--- old/src/java.xml.bind/share/classes/javax/xml/bind/annotation/adapters/HexBinaryAdapter.java 2015-09-19 13:15:50.560869255 +0300
+++ new/src/java.xml.bind/share/classes/javax/xml/bind/annotation/adapters/HexBinaryAdapter.java 2015-09-19 13:15:50.428868600 +0300
@@ -28,10 +28,10 @@
import javax.xml.bind.DatatypeConverter;
/**
- * {@link XmlAdapter} for xs:hexBinary .
+ * {@link XmlAdapter} for {@code xs:hexBinary}.
*
*
- * This {@link XmlAdapter} binds byte[] to the hexBinary representation in XML.
+ * This {@link XmlAdapter} binds {@code byte[]} to the hexBinary representation in XML.
*
* @author Kohsuke Kawaguchi
* @since 1.6, JAXB 2.0
--- old/src/java.xml.bind/share/classes/javax/xml/bind/annotation/adapters/NormalizedStringAdapter.java 2015-09-19 13:15:51.048871675 +0300
+++ new/src/java.xml.bind/share/classes/javax/xml/bind/annotation/adapters/NormalizedStringAdapter.java 2015-09-19 13:15:50.916871020 +0300
@@ -28,7 +28,7 @@
/**
- * {@link XmlAdapter} to handle xs:normalizedString .
+ * {@link XmlAdapter} to handle {@code xs:normalizedString}.
*
*
* Replaces any tab, CR, and LF by a whitespace character ' ',
--- old/src/java.xml.bind/share/classes/javax/xml/bind/annotation/adapters/XmlAdapter.java 2015-09-19 13:15:51.548874154 +0300
+++ new/src/java.xml.bind/share/classes/javax/xml/bind/annotation/adapters/XmlAdapter.java 2015-09-19 13:15:51.404873440 +0300
@@ -32,7 +32,7 @@
*
*
* Some Java types do not map naturally to a XML representation, for
- * example HashMap or other non JavaBean classes. Conversely,
+ * example {@code HashMap} or other non JavaBean classes. Conversely,
* a XML repsentation may map to a Java type but an application may
* choose to accesss the XML representation using another Java
* type. For example, the schema to Java binding rules bind
@@ -68,10 +68,10 @@
* XmlJavaTypeAdapter}
*
*
- * Example: Customized mapping of HashMap
+ * Example: Customized mapping of {@code HashMap}
* The following example illustrates the use of
- * @XmlAdapter and @XmlJavaTypeAdapter to
- * customize the mapping of a HashMap .
+ * {@code @XmlAdapter} and {@code @XmlJavaTypeAdapter} to
+ * customize the mapping of a {@code HashMap}.
*
*
Step 1: Determine the desired XML representation for HashMap.
*
@@ -154,7 +154,7 @@
* @param
* The type that JAXB doesn't know how to handle. An adapter is written
* to allow this type to be used as an in-memory representation through
- * the ValueType .
+ * the {@code ValueType}.
* @param
* The type that JAXB knows how to handle out of the box.
*
--- old/src/java.xml.bind/share/classes/javax/xml/bind/annotation/adapters/XmlJavaTypeAdapter.java 2015-09-19 13:15:52.048876633 +0300
+++ new/src/java.xml.bind/share/classes/javax/xml/bind/annotation/adapters/XmlJavaTypeAdapter.java 2015-09-19 13:15:51.904875919 +0300
@@ -50,7 +50,7 @@
*
* Usage:
*
- * The @XmlJavaTypeAdapter annotation can be used with the
+ *
The {@code @XmlJavaTypeAdapter} annotation can be used with the
* following program elements:
*
* a JavaBean property
@@ -60,20 +60,20 @@
* from within {@link XmlJavaTypeAdapters}
*
*
- * When @XmlJavaTypeAdapter annotation is defined on a
+ *
When {@code @XmlJavaTypeAdapter} annotation is defined on a
* class, it applies to all references to the class.
- *
When @XmlJavaTypeAdapter annotation is defined at the
+ *
When {@code @XmlJavaTypeAdapter} annotation is defined at the
* package level it applies to all references from within the package
- * to @XmlJavaTypeAdapter.type() .
- *
When @XmlJavaTypeAdapter annotation is defined on the
+ * to {@code @XmlJavaTypeAdapter.type()}.
+ *
When {@code @XmlJavaTypeAdapter} annotation is defined on the
* field, property or parameter, then the annotation applies to the
* field, property or the parameter only.
- *
A @XmlJavaTypeAdapter annotation on a field, property
- * or parameter overrides the @XmlJavaTypeAdapter annotation
+ *
A {@code @XmlJavaTypeAdapter} annotation on a field, property
+ * or parameter overrides the {@code @XmlJavaTypeAdapter} annotation
* associated with the class being referenced by the field, property
* or parameter.
- *
A @XmlJavaTypeAdapter annotation on a class overrides
- * the @XmlJavaTypeAdapter annotation specified at the
+ *
A {@code @XmlJavaTypeAdapter} annotation on a class overrides
+ * the {@code @XmlJavaTypeAdapter} annotation specified at the
* package level for that class.
*
*
This annotation can be used with the following other annotations:
--- old/src/java.xml.bind/share/classes/javax/xml/bind/annotation/adapters/XmlJavaTypeAdapters.java 2015-09-19 13:15:52.540879073 +0300
+++ new/src/java.xml.bind/share/classes/javax/xml/bind/annotation/adapters/XmlJavaTypeAdapters.java 2015-09-19 13:15:52.408878418 +0300
@@ -42,7 +42,7 @@
* @XmlJavaTypeAdapters ({ @XmlJavaTypeAdapter(...),@XmlJavaTypeAdapter(...) })
*
*
- *
The @XmlJavaTypeAdapters annotation is useful for
+ *
The {@code @XmlJavaTypeAdapters} annotation is useful for
* defining {@link XmlJavaTypeAdapter} annotations for different types
* at the package level.
*
--- old/src/java.xml.bind/share/classes/javax/xml/bind/attachment/AttachmentMarshaller.java 2015-09-19 13:15:53.040881552 +0300
+++ new/src/java.xml.bind/share/classes/javax/xml/bind/attachment/AttachmentMarshaller.java 2015-09-19 13:15:52.892880818 +0300
@@ -123,7 +123,7 @@
*
* @param data
* represents the data to be attached. Must be non-null. The actual data region is
- * specified by (data,offset,length) tuple.
+ * specified by {@code (data,offset,length)} tuple.
*
* @param offset
* The offset within the array of the first byte to be read;
--- old/src/java.xml.bind/share/classes/javax/xml/bind/attachment/AttachmentUnmarshaller.java 2015-09-19 13:15:53.540884032 +0300
+++ new/src/java.xml.bind/share/classes/javax/xml/bind/attachment/AttachmentUnmarshaller.java 2015-09-19 13:15:53.400883338 +0300
@@ -36,9 +36,10 @@
* understanding of the packaging format being used to a MIME-based
* package processor that implements this abstract class.
*
- * This abstract class identifies if a package requires XOP processing, {@link #isXOPPackage()} and provides retrieval of binary content stored as attachments by content-id.
+ * This abstract class identifies if a package requires XOP processing, {@link #isXOPPackage()}
+ * and provides retrieval of binary content stored as attachments by content-id.
*
- * Identifying the content-id, cid, to pass to getAttachment*(String cid)
+ * Identifying the content-id, cid, to pass to {@code getAttachment*(String cid)}
*
*
@@ -66,9 +68,9 @@
*/
public abstract class AttachmentUnmarshaller {
/**
- * Lookup MIME content by content-id, cid, and return as a {@link DataHandler}.
+ * Lookup MIME content by content-id, {@code cid}, and return as a {@link DataHandler}.
*
- * The returned DataHandler instance must be configured
+ *
The returned {@code DataHandler} instance must be configured
* to meet the following required mapping constaint.
*
*
@@ -81,8 +83,8 @@
* Java Type
*
*
- * DataHandler.getContentType()instanceof DataHandler.getContent(){@code DataHandler.getContentType()}
+ * {@code instanceof DataHandler.getContent()}
*
*
*
@@ -103,8 +105,8 @@
* Note that it is allowable to support additional mappings.
*
* @param cid It is expected to be a valid lexical form of the XML Schema
- * xs:anyURI datatype. If {@link #isXOPPackage()}
- * ==true, it must be a valid URI per the cid: URI scheme (see RFC 2387 )
+ * {@code xs:anyURI} datatype. If {@link #isXOPPackage()}{@code ==true},
+ * it must be a valid URI per the {@code cid:} URI scheme (see RFC 2387 )
*
* @return
* a {@link DataHandler} that represents the MIME attachment.
@@ -114,11 +116,11 @@
public abstract DataHandler getAttachmentAsDataHandler(String cid);
/**
- * Retrieve the attachment identified by content-id, cid, as a byte[]
.
+ * Retrieve the attachment identified by content-id, {@code cid}, as a {@code byte[]}.
*
* @param cid It is expected to be a valid lexical form of the XML Schema
- * xs:anyURI datatype. If {@link #isXOPPackage()}
- * ==true, it must be a valid URI per the cid: URI scheme (see RFC 2387 )
+ * {@code xs:anyURI} datatype. If {@link #isXOPPackage()}{@code ==true},
+ * it must be a valid URI per the {@code cid:} URI scheme (see RFC 2387 )
*
* @return byte[] representation of attachment identified by cid.
*
@@ -129,7 +131,7 @@
/**
*
Read-only property that returns true if JAXB unmarshaller needs to perform XOP processing.
*
- * This method returns true when the constraints specified
+ *
This method returns {@code true} when the constraints specified
* in Identifying XOP Documents are met.
* This value must not change during the unmarshalling process.
*
--- old/src/java.xml.bind/share/classes/javax/xml/bind/helpers/AbstractMarshallerImpl.java 2015-09-19 13:15:54.040886511 +0300
+++ new/src/java.xml.bind/share/classes/javax/xml/bind/helpers/AbstractMarshallerImpl.java 2015-09-19 13:15:53.892885777 +0300
@@ -48,7 +48,7 @@
// import java.nio.charset.UnsupportedCharsetException;
/**
- * Partial default Marshaller implementation.
+ * Partial default {@code Marshaller} implementation.
*
*
* This class provides a partial default implementation for the
--- old/src/java.xml.bind/share/classes/javax/xml/bind/helpers/AbstractUnmarshallerImpl.java 2015-09-19 13:15:54.540888991 +0300
+++ new/src/java.xml.bind/share/classes/javax/xml/bind/helpers/AbstractUnmarshallerImpl.java 2015-09-19 13:15:54.408888336 +0300
@@ -53,7 +53,7 @@
import java.net.URL;
/**
- * Partial default Unmarshaller implementation.
+ * Partial default {@code Unmarshaller} implementation.
*
*
* This class provides a partial default implementation for the
@@ -246,7 +246,7 @@
*
* The validation event handler will be called by the JAXB Provider if any
* validation errors are encountered during calls to any of the
- * unmarshal methods. If the client application does not register
+ * {@code unmarshal} methods. If the client application does not register
* a validation event handler before invoking the unmarshal methods, then
* all validation events will be silently ignored and may result in
* unexpected behaviour.
@@ -267,7 +267,7 @@
/**
* Specifies whether or not the Unmarshaller should validate during
- * unmarshal operations. By default, the Unmarshaller does
+ * unmarshal operations. By default, the {@code Unmarshaller} does
* not validate.
*
* This method may only be invoked before or after calling one of the
--- old/src/java.xml.bind/share/classes/javax/xml/bind/helpers/package.html 2015-09-19 13:15:55.040891470 +0300
+++ new/src/java.xml.bind/share/classes/javax/xml/bind/helpers/package.html 2015-09-19 13:15:54.900890776 +0300
@@ -34,7 +34,7 @@
JAXB Provider Use Only: Provides partial default implementations for
- some of the javax.xml.bind interfaces.
+ some of the javax.xml.bind interfaces.
JAXB Providers can extend these classes and implement the abstract
--- old/src/java.xml.bind/share/classes/javax/xml/bind/package.html 2015-09-19 13:15:55.528893890 +0300
+++ new/src/java.xml.bind/share/classes/javax/xml/bind/package.html 2015-09-19 13:15:55.396893235 +0300
@@ -37,7 +37,7 @@
unmarshalling, marshalling, and validation capabilities.
- JAXBContext is the client-entry point to the runtime binding
+ JAXBContext is the client-entry point to the runtime binding
framework.
--- old/src/java.xml.ws/share/classes/com/sun/xml/internal/messaging/saaj/SOAPExceptionImpl.java 2015-09-19 13:15:56.024896349 +0300
+++ new/src/java.xml.ws/share/classes/com/sun/xml/internal/messaging/saaj/SOAPExceptionImpl.java 2015-09-19 13:15:55.884895655 +0300
@@ -144,7 +144,7 @@
* @param cause the Throwable object that caused this
* SOAPExceptionImpl object to be thrown. The value of this
* parameter is saved for later retrieval by the
- * {@link #getCause()} method. A null value is
+ * {@link #getCause()} method. A {@code null} value is
* permitted and indicates that the cause is nonexistent or
* unknown.
* @return a reference to this SOAPExceptionImpl instance
--- old/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/addressing/WsaPropertyBag.java 2015-09-19 13:15:56.516898789 +0300
+++ new/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/addressing/WsaPropertyBag.java 2015-09-19 13:15:56.380898115 +0300
@@ -69,7 +69,7 @@
}
/**
- * Gets the wsa:To header.
+ * Gets the {@code wsa:To} header.
*
* @return
* null if the incoming SOAP message didn't have the header.
@@ -85,7 +85,7 @@
}
/**
- * Gets the wsa:To header.
+ * Gets the {@code wsa:To} header.
*
* @return
* null if the incoming SOAP message didn't have the header.
@@ -101,7 +101,7 @@
}
/**
- * Gets the wsa:From header.
+ * Gets the {@code wsa:From} header.
*
* @return
* null if the incoming SOAP message didn't have the header.
@@ -112,7 +112,7 @@
}
/**
- * Gets the wsa:Action header content as String.
+ * Gets the {@code wsa:Action} header content as String.
*
* @return
* null if the incoming SOAP message didn't have the header.
@@ -128,7 +128,7 @@
}
/**
- * Gets the wsa:MessageID header content as String.
+ * Gets the {@code wsa:MessageID} header content as String.
*
* @return
* null if the incoming SOAP message didn't have the header.
--- old/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/api/BindingID.java 2015-09-19 13:15:57.008901229 +0300
+++ new/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/api/BindingID.java 2015-09-19 13:15:56.872900554 +0300
@@ -164,7 +164,7 @@
*
*
* For example, {@link BindingID} for
- * "{@value SOAPBinding#SOAP11HTTP_MTOM_BINDING}"
+ * {@code "{@value SOAPBinding#SOAP11HTTP_MTOM_BINDING}"}
* would always return a list that has {@link MTOMFeature} enabled.
*/
public WebServiceFeatureList createBuiltinFeatureList() {
@@ -189,7 +189,7 @@
*
*
* Some binding ID, such as those for SOAP/HTTP, uses the URL
- * query syntax (like ?mtom=true ) to control
+ * query syntax (like {@code ?mtom=true}) to control
* the optional part of the binding. This method obtains
* the value for such optional parts.
*
--- old/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/api/BindingIDFactory.java 2015-09-19 13:15:57.508903708 +0300
+++ new/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/api/BindingIDFactory.java 2015-09-19 13:15:57.372903034 +0300
@@ -36,7 +36,7 @@
*
* When the JAX-WS RI is asked to parse a binding ID string into a {@link BindingID}
* object, it uses service idiom to look for the implementations of this class
- * in the META-INF/services/... .
+ * in the {@code META-INF/services/...}.
*
* @since JAX-WS 2.0.next
* @author Kohsuke Kawaguchi
--- old/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/api/Cancelable.java 2015-09-19 13:15:58.000906148 +0300
+++ new/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/api/Cancelable.java 2015-09-19 13:15:57.860905454 +0300
@@ -35,18 +35,18 @@
* Attempts to cancel execution of this task. This attempt will
* fail if the task has already completed, has already been cancelled,
* or could not be cancelled for some other reason. If successful,
- * and this task has not started when cancel is called,
+ * and this task has not started when {@code cancel} is called,
* this task should never run. If the task has already started,
- * then the mayInterruptIfRunning parameter determines
+ * then the {@code mayInterruptIfRunning} parameter determines
* whether the thread executing this task should be interrupted in
* an attempt to stop the task.
*
- * @param mayInterruptIfRunning true if the thread executing this
+ * @param mayInterruptIfRunning {@code true} if the thread executing this
* task should be interrupted; otherwise, in-progress tasks are allowed
* to complete
- * @return false if the task could not be cancelled,
+ * @return {@code false} if the task could not be cancelled,
* typically because it has already completed normally;
- * true otherwise
+ * {@code true} otherwise
*/
public void cancel(boolean mayInterruptIfRunning);
}
--- old/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/api/client/ClientPipelineHook.java 2015-09-19 13:15:58.508908667 +0300
+++ new/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/api/client/ClientPipelineHook.java 2015-09-19 13:15:58.356907913 +0300
@@ -63,7 +63,7 @@
* eventually processes messages.
*
* @return
- * The default implementation just returns tail , which means
+ * The default implementation just returns {@code tail}, which means
* no additional pipe is inserted. If the implementation adds
* new pipes, return the new head pipe.
*/
--- old/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/api/client/ServiceInterceptor.java 2015-09-19 13:15:58.996911087 +0300
+++ new/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/api/client/ServiceInterceptor.java 2015-09-19 13:15:58.864910432 +0300
@@ -68,7 +68,7 @@
* @return
* A set of features to be added to the newly created {@link WSBinding}.
* Can be empty but never null.
- * defaultFeatures will take precedence over what this method
+ * {@code defaultFeatures} will take precedence over what this method
* would return (because it includes user-specified ones which will
* take the at-most priority), but features you return from this method
* will take precedence over {@link BindingID}'s
--- old/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/api/message/Header.java 2015-09-19 13:15:59.492913546 +0300
+++ new/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/api/message/Header.java 2015-09-19 13:15:59.356912872 +0300
@@ -101,7 +101,7 @@
* specifically, this method has to perform the following tasks:
*
*
- * If this header does not have mustUnderstand as "1" nor "true",
+ * If this header does not have {@code mustUnderstand} as "1" nor "true",
* then this method must return true.
* Otherwise, check the role attribute (for SOAP 1.2) or the actor attribute (for SOAP 1.1).
* When those attributes are absent, the default values have to be assumed.
@@ -300,7 +300,7 @@
*
*
* A header is responsible for producing the SAX events for its part,
- * including startPrefixMapping and endPrefixMapping ,
+ * including {@code startPrefixMapping} and {@code endPrefixMapping},
* but not startDocument/endDocument.
*
*
--- old/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/api/message/HeaderList.java 2015-09-19 13:15:59.992916026 +0300
+++ new/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/api/message/HeaderList.java 2015-09-19 13:15:59.848915312 +0300
@@ -87,13 +87,13 @@
* There are two ways to mark a header as understood:
*
*
- * Use one of the getXXX methods that take a
- * boolean markAsUnderstood parameter.
+ * Use one of the {@code getXXX} methods that take a
+ * boolean {@code markAsUnderstood} parameter.
* Most often, a {@link Pipe} knows it's going to understand a header
* as long as it's present, so this is the easiest and thus the preferred way.
*
* For example, if JAX-WSA looks for <wsa:To>, then it can set
- * markAsUnderstand to true, to do the obtaining of a header
+ * {@code markAsUnderstand} to true, to do the obtaining of a header
* and marking at the same time.
*
* Call {@link #understood(int)}.
@@ -489,14 +489,14 @@
}
/**
- * Returns the value of WS-Addressing To header. The version
+ * Returns the value of WS-Addressing {@code To} header. The {@code version}
* identifies the WS-Addressing version and the header returned is targeted at
* the current implicit role. Caches the value for subsequent invocation.
- * Duplicate To headers are detected earlier.
+ * Duplicate {@code To} headers are detected earlier.
*
* @param av WS-Addressing version
* @param sv SOAP version
- * @throws IllegalArgumentException if either av or sv is null.
+ * @throws IllegalArgumentException if either {@code av} or {@code sv} is null.
* @return Value of WS-Addressing To header, anonymous URI if no header is present
*/
public String getTo(AddressingVersion av, SOAPVersion sv) {
@@ -504,14 +504,14 @@
}
/**
- * Returns the value of WS-Addressing Action header. The version
+ * Returns the value of WS-Addressing {@code Action} header. The {@code version}
* identifies the WS-Addressing version and the header returned is targeted at
* the current implicit role. Caches the value for subsequent invocation.
- * Duplicate Action headers are detected earlier.
+ * Duplicate {@code Action} headers are detected earlier.
*
* @param av WS-Addressing version
* @param sv SOAP version
- * @throws IllegalArgumentException if either av or sv is null.
+ * @throws IllegalArgumentException if either {@code av} or {@code sv} is null.
* @return Value of WS-Addressing Action header, null if no header is present
*/
public String getAction(@NotNull AddressingVersion av, @NotNull SOAPVersion sv) {
@@ -519,14 +519,14 @@
}
/**
- * Returns the value of WS-Addressing ReplyTo header. The version
+ * Returns the value of WS-Addressing {@code ReplyTo} header. The {@code version}
* identifies the WS-Addressing version and the header returned is targeted at
* the current implicit role. Caches the value for subsequent invocation.
- * Duplicate ReplyTo headers are detected earlier.
+ * Duplicate {@code ReplyTo} headers are detected earlier.
*
* @param av WS-Addressing version
* @param sv SOAP version
- * @throws IllegalArgumentException if either av or sv is null.
+ * @throws IllegalArgumentException if either {@code av} or {@code sv} is null.
* @return Value of WS-Addressing ReplyTo header, null if no header is present
*/
public WSEndpointReference getReplyTo(@NotNull AddressingVersion av, @NotNull SOAPVersion sv) {
@@ -534,14 +534,14 @@
}
/**
- * Returns the value of WS-Addressing FaultTo header. The version
+ * Returns the value of WS-Addressing {@code FaultTo} header. The {@code version}
* identifies the WS-Addressing version and the header returned is targeted at
* the current implicit role. Caches the value for subsequent invocation.
- * Duplicate FaultTo headers are detected earlier.
+ * Duplicate {@code FaultTo} headers are detected earlier.
*
* @param av WS-Addressing version
* @param sv SOAP version
- * @throws IllegalArgumentException if either av or sv is null.
+ * @throws IllegalArgumentException if either {@code av} or {@code sv} is null.
* @return Value of WS-Addressing FaultTo header, null if no header is present
*/
public WSEndpointReference getFaultTo(@NotNull AddressingVersion av, @NotNull SOAPVersion sv) {
@@ -549,14 +549,14 @@
}
/**
- * Returns the value of WS-Addressing MessageID header. The version
+ * Returns the value of WS-Addressing {@code MessageID} header. The {@code version}
* identifies the WS-Addressing version and the header returned is targeted at
* the current implicit role. Caches the value for subsequent invocation.
- * Duplicate MessageID headers are detected earlier.
+ * Duplicate {@code MessageID} headers are detected earlier.
*
* @param av WS-Addressing version
* @param sv SOAP version
- * @throws WebServiceException if either av or sv is null.
+ * @throws WebServiceException if either {@code av} or {@code sv} is null.
* @return Value of WS-Addressing MessageID header, null if no header is present
*/
public String getMessageID(@NotNull AddressingVersion av, @NotNull SOAPVersion sv) {
@@ -564,14 +564,14 @@
}
/**
- * Returns the value of WS-Addressing RelatesTo header. The version
+ * Returns the value of WS-Addressing {@code RelatesTo} header. The {@code version}
* identifies the WS-Addressing version and the header returned is targeted at
* the current implicit role. Caches the value for subsequent invocation.
- * Duplicate RelatesTo headers are detected earlier.
+ * Duplicate {@code RelatesTo} headers are detected earlier.
*
* @param av WS-Addressing version
* @param sv SOAP version
- * @throws WebServiceException if either av or sv is null.
+ * @throws WebServiceException if either {@code av} or {@code sv} is null.
* @return Value of WS-Addressing RelatesTo header, null if no header is present
*/
public String getRelatesTo(@NotNull AddressingVersion av, @NotNull SOAPVersion sv) {
@@ -803,14 +803,15 @@
/**
* Removes a single instance of the specified element from this
* header list, if it is present. More formally,
- * removes a header h such that (o==null ? h==null :
- * o.equals(h)) , if the header list contains one or more such
- * headers. Returns true if the list contained the
+ * removes a header {@code h} such that
+ * {@code (o==null ? h==null : o.equals(h))},
+ * if the header list contains one or more such
+ * headers. Returns {@code true} if the list contained the
* specified element (or equivalently, if the list changed as a
* result of the call).
*
* @param o element to be removed from this list, if present.
- * @return true if the list contained the specified element.
+ * @return {@code true} if the list contained the specified element.
* @see #remove(javax.xml.namespace.QName)
*/
@Override
--- old/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/api/message/Message.java 2015-09-19 13:16:00.504918565 +0300
+++ new/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/api/message/Message.java 2015-09-19 13:16:00.368917890 +0300
@@ -446,14 +446,14 @@
*
*
* A message without a payload is a SOAP message that looks like:
- *
<![CDATA[
+ * <pre>{@code
* <S:Envelope>
* <S:Header>
* ...
* </S:Header>
* <S:Body />
* </S:Envelope>
- * ]]>
* Transports may choose to ignore certain headers that interfere with
* its correct operation, such as
- * Content-Type and Content-Length .
+ * {@code Content-Type} and {@code Content-Length}.
*/
public static final String OUTBOUND_TRANSPORT_HEADERS = "com.sun.xml.internal.ws.api.message.packet.outbound.transport.headers";
@@ -588,7 +588,7 @@
*
*
* For outgoing messages, the transport may sends out this value.
- * If this field is null, the transport may choose to send ""
+ * If this field is null, the transport may choose to send {@code ""}
* (quoted empty string.)
*
* For incoming messages, the transport will set this field.
--- old/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/api/model/Parameter.java 2015-09-19 13:16:01.520923603 +0300
+++ new/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/api/model/Parameter.java 2015-09-19 13:16:01.388922948 +0300
@@ -81,7 +81,7 @@
int getIndex();
/**
- * @return true if this instanceof {@link com.sun.xml.internal.ws.model.WrapperParameter} .
+ * @return true if {@code this instanceof} {@link com.sun.xml.internal.ws.model.WrapperParameter}.
*/
boolean isWrapperStyle();
@@ -89,7 +89,7 @@
* Returns true if this parameter is bound to the return value from the {@link JavaMethod}.
*
*
- * Just the convenience method for getIndex()==-1
+ * Just the convenience method for {@code getIndex()==-1}
*/
boolean isReturnValue();
@@ -138,7 +138,7 @@
*
* {@link JavaMethod#getResponseParameters()} is guaranteed to have
* at most one such {@link Parameter}. Note that there coule be none,
- * in which case the method returns void .
+ * in which case the method returns {@code void}.
*
*
* Other response parameters are bound to {@link Holder}.
--- old/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/api/pipe/Codec.java 2015-09-19 13:16:02.020926082 +0300
+++ new/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/api/pipe/Codec.java 2015-09-19 13:16:01.876925368 +0300
@@ -179,7 +179,7 @@
*
* If the {@link Codec} implementation is already
* re-entrant and multi-thread safe to begin with,
- * then this method may simply return this .
+ * then this method may simply return {@code this}.
*/
Codec copy();
@@ -208,7 +208,7 @@
* The MIME content type (like "application/xml") of this byte stream.
* Thie text includes all the sub-headers of the content-type header. Therefore,
* in more complex case, this could be something like
- * multipart/related; boundary="--=_outer_boundary"; type="multipart/alternative" .
+ * {@code multipart/related; boundary="--=_outer_boundary"; type="multipart/alternative"}.
* This parameter must not be null.
*
* @param response
--- old/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/api/pipe/Fiber.java 2015-09-19 13:16:02.520928561 +0300
+++ new/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/api/pipe/Fiber.java 2015-09-19 13:16:02.376927847 +0300
@@ -319,7 +319,7 @@
* This method works like {@link Thread#start()}.
*
* @param tubeline The first tube of the tubeline that will act on the packet.
- * @param request The request packet to be passed to startPoint.processRequest() .
+ * @param request The request packet to be passed to {@code startPoint.processRequest()}.
* @param completionCallback The callback to be invoked when the processing is finished and the
* final response packet is available.
* @see #runSync(Tube, Packet)
@@ -385,7 +385,7 @@
* @param tubeline
* The first tube of the tubeline that will act on the packet.
* @param request
- * The request packet to be passed to startPoint.processRequest() .
+ * The request packet to be passed to {@code startPoint.processRequest()}.
* @param completionCallback
* The callback to be invoked when the processing is finished and the
* final response packet is available.
@@ -835,8 +835,8 @@
*
*
* @param tubeline The first tube of the tubeline that will act on the packet.
- * @param request The request packet to be passed to startPoint.processRequest() .
- * @return The response packet to the request .
+ * @param request The request packet to be passed to {@code startPoint.processRequest()}.
+ * @return The response packet to the {@code request}.
* @see #start(Tube, Packet, CompletionCallback)
*/
public
--- old/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/api/pipe/FiberContextSwitchInterceptor.java 2015-09-19 13:16:03.032931100 +0300
+++ new/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/api/pipe/FiberContextSwitchInterceptor.java 2015-09-19 13:16:02.892930406 +0300
@@ -44,7 +44,7 @@
*
* The design also encapsulates the entire fiber execution in a single
* opaque method invocation {@link Work#execute}, allowing the use of
- * finally block.
+ * {@code finally} block.
*
*
* @author Kohsuke Kawaguchi
--- old/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/api/pipe/Pipe.java 2015-09-19 13:16:03.532933580 +0300
+++ new/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/api/pipe/Pipe.java 2015-09-19 13:16:03.392932885 +0300
@@ -177,7 +177,7 @@
*
*
VM-wide state
*
- * static is always there for you to use.
+ * {@code static} is always there for you to use.
*
*
*
@@ -323,7 +323,7 @@
* that you delegate to.
*
* For limited number of {@link Pipe}s that do not maintain any
- * thread unsafe resource, it is allowed to simply return this
+ * thread unsafe resource, it is allowed to simply return {@code this}
* from this method (notice that even if you are stateless, if you
* got a delegating {@link Pipe} and that one isn't stateless, you
* still have to copy yourself.)
--- old/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/api/pipe/PipelineAssemblerFactory.java 2015-09-19 13:16:04.032936059 +0300
+++ new/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/api/pipe/PipelineAssemblerFactory.java 2015-09-19 13:16:03.892935365 +0300
@@ -37,7 +37,7 @@
*
* To create a pipeline,
* the JAX-WS runtime locates {@link PipelineAssemblerFactory}s through
- * the META-INF/services/com.sun.xml.internal.ws.api.pipe.PipelineAssemblerFactory files.
+ * the {@code META-INF/services/com.sun.xml.internal.ws.api.pipe.PipelineAssemblerFactory} files.
* Factories found are checked to see if it supports the given binding ID one by one,
* and the first valid {@link PipelineAssembler} returned will be used to create
* a pipeline.
--- old/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/api/pipe/Stubs.java 2015-09-19 13:16:04.520938479 +0300
+++ new/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/api/pipe/Stubs.java 2015-09-19 13:16:04.392937844 +0300
@@ -75,9 +75,9 @@
*
Pipe next
*
* Stubs turn a method invocation into a {@link Pipe#process(com.sun.xml.internal.ws.api.message.Packet)} invocation,
- * and this pipe passed in as the next parameter will receive a {@link Message}
+ * and this pipe passed in as the {@code next} parameter will receive a {@link Message}
* from newly created stub. All the methods taking Tube <> parameter are deprecated. JAX-WS Runtime takes care of
- * creating the tubeline when the next parameter is not passed. This gives flexibility for the JAX-WS Runtime
+ * creating the tubeline when the {@code next} parameter is not passed. This gives flexibility for the JAX-WS Runtime
* to pass extra information during the tube line creation via {@link ClientTubeAssemblerContext}.
*
* WSPortInfo portInfo
@@ -87,7 +87,7 @@
* BindingImpl binding
*
* Stubs implement {@link BindingProvider}, and its {@link BindingProvider#getBinding()}
- * will return this binding object. Stubs often also use this information
+ * will return this {@code binding} object. Stubs often also use this information
* to decide which SOAP version a {@link Message} should be created in.
*
*
{@link WSService} service
@@ -98,7 +98,7 @@
* {@link WSEndpointReference} epr
*
* If you want the created {@link Dispatch} to talk to the given EPR, specify the parameter.
- * Otherwise leave it null . Note that the addressing needs to be enabled separately
+ * Otherwise leave it {@code null}. Note that the addressing needs to be enabled separately
* for this to take effect.
*
* @author Kohsuke Kawaguchi
--- old/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/api/pipe/Tube.java 2015-09-19 13:16:05.020940958 +0300
+++ new/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/api/pipe/Tube.java 2015-09-19 13:16:04.880940264 +0300
@@ -203,7 +203,7 @@
*
*
VM-wide state
*
- * static is always there for you to use.
+ * {@code static} is always there for you to use.
*
*
*
@@ -373,7 +373,7 @@
* that you delegate to.
*
* For limited number of {@link Tube}s that do not maintain any
- * thread unsafe resource, it is allowed to simply return this
+ * thread unsafe resource, it is allowed to simply return {@code this}
* from this method (notice that even if you are stateless, if you
* got a delegating {@link Tube} and that one isn't stateless, you
* still have to copy yourself.)
--- old/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/api/pipe/TubelineAssemblerFactory.java 2015-09-19 13:16:05.520943438 +0300
+++ new/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/api/pipe/TubelineAssemblerFactory.java 2015-09-19 13:16:05.388942783 +0300
@@ -42,7 +42,7 @@
*
* To create a tubeline,
* the JAX-WS runtime locates {@link TubelineAssemblerFactory}s through
- * the META-INF/services/com.sun.xml.internal.ws.api.pipe.TubelineAssemblerFactory files.
+ * the {@code META-INF/services/com.sun.xml.internal.ws.api.pipe.TubelineAssemblerFactory} files.
* Factories found are checked to see if it supports the given binding ID one by one,
* and the first valid {@link TubelineAssembler} returned will be used to create
* a tubeline.
--- old/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/api/server/Container.java 2015-09-19 13:16:06.024945937 +0300
+++ new/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/api/server/Container.java 2015-09-19 13:16:05.876945203 +0300
@@ -50,12 +50,12 @@
* from a container, they can do the following:
*
* Negotiate an interface with the container and define it.
- * (let's call it ContainerSecuritySPI .)
- * The container will implement ContainerSecuritySPI .
+ * (let's call it {@code ContainerSecuritySPI}.)
+ * The container will implement {@code ContainerSecuritySPI}.
* At the runtime, a security pipe gets
* {@link WSEndpoint} and then to {@link Container}.
- * It calls container.getSPI(ContainerSecuritySPI.class)
- * The container returns an instance of ContainerSecuritySPI .
+ * It calls {@code container.getSPI(ContainerSecuritySPI.class)}
+ * The container returns an instance of {@code ContainerSecuritySPI}.
* The security pipe talks to the container through this SPI.
*
*
--- old/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/api/server/Invoker.java 2015-09-19 13:16:06.524948416 +0300
+++ new/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/api/server/Invoker.java 2015-09-19 13:16:06.380947702 +0300
@@ -39,7 +39,7 @@
*
* Typical host of the JAX-WS RI would want to use
* {@link InstanceResolver#createDefault(Class)} and then
- * use {@link InstanceResolver#createInvoker()} to obtain
+ * use {@link InstanceResolver#createInvoker()} to obtain
* the default invoker implementation.
*
*
--- old/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/api/server/ServerPipelineHook.java 2015-09-19 13:16:07.016950856 +0300
+++ new/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/api/server/ServerPipelineHook.java 2015-09-19 13:16:06.876950162 +0300
@@ -63,7 +63,7 @@
* eventually processes messages.
*
* @return
- * The default implementation just returns tail , which means
+ * The default implementation just returns {@code tail}, which means
* no additional pipe is inserted. If the implementation adds
* new pipes, return the new head pipe.
*/
@@ -89,7 +89,7 @@
* eventually processes messages.
*
* @return
- * The default implementation just returns tail , which means
+ * The default implementation just returns {@code tail}, which means
* no additional pipe is inserted. If the implementation adds
* new pipes, return the new head pipe.
*/
--- old/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/api/server/WSEndpoint.java 2015-09-19 13:16:07.504953276 +0300
+++ new/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/api/server/WSEndpoint.java 2015-09-19 13:16:07.372952621 +0300
@@ -473,7 +473,7 @@
* This method works like the following:
*
* {@link ServiceDefinition} is modeleed from the given SEI type.
- * {@link Invoker} that always serves implementationObject will be used.
+ * {@link Invoker} that always serves {@code implementationObject} will be used.
*
* @param implType
* Endpoint class(not SEI). Enpoint class must have @WebService or @WebServiceProvider
@@ -521,7 +521,7 @@
* WSDL. Must be null if the {@code url} is null.
* @param isTransportSynchronous
* If the caller knows that the returned {@link WSEndpoint} is going to be
- * used by a synchronous-only transport, then it may pass in true
+ * used by a synchronous-only transport, then it may pass in {@code true}
* to allow the callee to perform an optimization based on that knowledge
* (since often synchronous version is cheaper than an asynchronous version.)
* This value is visible from {@link ServerTubeAssemblerContext#isSynchronous()}.
@@ -583,7 +583,7 @@
}
/**
- * Deprecated version that assumes isTransportSynchronous==false
+ * Deprecated version that assumes {@code isTransportSynchronous==false}
*/
@Deprecated
public static WSEndpoint create(
@@ -604,7 +604,7 @@
/**
* The same as
* {@link #create(Class, boolean, Invoker, QName, QName, Container, WSBinding, SDDocumentSource, Collection, EntityResolver)}
- * except that this version takes an url of the jax-ws-catalog.xml .
+ * except that this version takes an url of the {@code jax-ws-catalog.xml}.
*
* @param catalogUrl
* if not null, an {@link EntityResolver} is created from it and used.
--- old/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/api/server/WebModule.java 2015-09-19 13:16:08.004955755 +0300
+++ new/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/api/server/WebModule.java 2015-09-19 13:16:07.868955081 +0300
@@ -43,7 +43,7 @@
* this URI.
*
*
- * This method follows the convention of the HttpServletRequest.getContextPath() ,
+ * This method follows the convention of the {@code HttpServletRequest.getContextPath()},
* and accepts strings like "http://myhost" (for web applications that are deployed
* to the root context path), or "http://myhost/foobar" (for web applications
* that are deployed to context path "/foobar")
--- old/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/api/wsdl/parser/WSDLParserExtension.java 2015-09-19 13:16:08.504958235 +0300
+++ new/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/api/wsdl/parser/WSDLParserExtension.java 2015-09-19 13:16:08.360957521 +0300
@@ -135,7 +135,7 @@
*
* The JAX-WS RI locates the implementation of {@link WSDLParserExtension}s
* by using the standard service look up mechanism, in particular looking for
- * META-INF/services/com.sun.xml.internal.ws.api.wsdl.parser.WSDLParserExtension
+ * {@code META-INF/services/com.sun.xml.internal.ws.api.wsdl.parser.WSDLParserExtension}
*
*
*
TODO
--- old/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/client/RequestContext.java 2015-09-19 13:16:09.004960714 +0300
+++ new/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/client/RequestContext.java 2015-09-19 13:16:08.860960000 +0300
@@ -169,7 +169,7 @@
*
*
* For outgoing messages, the transport may sends out this value.
- * If this field is null, the transport may choose to send ""
+ * If this field is null, the transport may choose to send {@code ""}
* (quoted empty string.)
*
* For incoming messages, the transport will set this field.
--- old/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/client/Stub.java 2015-09-19 13:16:09.516963253 +0300
+++ new/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/client/Stub.java 2015-09-19 13:16:09.364962499 +0300
@@ -188,7 +188,7 @@
* @param epr To create a stub that sends out reference parameters
* of a specific EPR, give that instance. Otherwise null.
* Its address field will not be used, and that should be given
- * separately as the defaultEndPointAddress .
+ * separately as the {@code defaultEndPointAddress}.
*/
@Deprecated
protected Stub(WSServiceDelegate owner, Tube master, BindingImpl binding, WSDLPort wsdlPort, EndpointAddress defaultEndPointAddress, @Nullable WSEndpointReference epr) {
@@ -205,7 +205,7 @@
* @param epr To create a stub that sends out reference parameters
* of a specific EPR, give that instance. Otherwise null.
* Its address field will not be used, and that should be given
- * separately as the defaultEndPointAddress .
+ * separately as the {@code defaultEndPointAddress}.
*/
@Deprecated
protected Stub(QName portname, WSServiceDelegate owner, Tube master, BindingImpl binding, WSDLPort wsdlPort, EndpointAddress defaultEndPointAddress, @Nullable WSEndpointReference epr) {
@@ -222,7 +222,7 @@
* @param epr To create a stub that sends out reference parameters
* of a specific EPR, give that instance. Otherwise null.
* Its address field will not be used, and that should be given
- * separately as the defaultEndPointAddress .
+ * separately as the {@code defaultEndPointAddress}.
*/
protected Stub(WSPortInfo portInfo, BindingImpl binding, Tube master,EndpointAddress defaultEndPointAddress, @Nullable WSEndpointReference epr) {
this((WSServiceDelegate) portInfo.getOwner(), master, portInfo, null, binding,portInfo.getPort(), defaultEndPointAddress, epr);
@@ -237,7 +237,7 @@
* @param epr To create a stub that sends out reference parameters
* of a specific EPR, give that instance. Otherwise null.
* Its address field will not be used, and that should be given
- * separately as the defaultEndPointAddress .
+ * separately as the {@code defaultEndPointAddress}.
*/
protected Stub(WSPortInfo portInfo, BindingImpl binding, EndpointAddress defaultEndPointAddress, @Nullable WSEndpointReference epr) {
this(portInfo,binding,null, defaultEndPointAddress,epr);
--- old/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/client/WSServiceDelegate.java 2015-09-19 13:16:10.016965732 +0300
+++ new/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/client/WSServiceDelegate.java 2015-09-19 13:16:09.884965078 +0300
@@ -341,8 +341,8 @@
/**
* Parses the WSDL and builds {@link com.sun.xml.internal.ws.api.model.wsdl.WSDLModel}.
* @param wsdlDocumentLocation
- * Either this or wsdl parameter must be given.
- * Null location means the system won't be able to resolve relative references in the WSDL,
+ * Either this or {@code wsdl} parameter must be given.
+ * Null location means the system won't be able to resolve relative references in the WSDL.
*/
private WSDLModel parseWSDL(URL wsdlDocumentLocation, Source wsdlSource, Class serviceClass) {
try {
--- old/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/client/sei/ValueSetter.java 2015-09-19 13:16:10.528968271 +0300
+++ new/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/client/sei/ValueSetter.java 2015-09-19 13:16:10.388967577 +0300
@@ -57,14 +57,14 @@
* @param obj
* The unmarshalled object.
* @param args
- * The arguments given to the Java method invocation. If obj
+ * The arguments given to the Java method invocation. If {@code obj}
* is supposed to be returned as a {@link Holder} value, a suitable
- * {@link Holder} is obtained from this argument list and obj
+ * {@link Holder} is obtained from this argument list and {@code obj}
* is set.
*
* @return
- * if obj is supposed to be returned as a return value
- * from the method, this method returns obj . Otherwise null.
+ * if {@code obj} is supposed to be returned as a return value
+ * from the method, this method returns {@code obj}. Otherwise null.
*/
abstract Object put(Object obj, Object[] args);
--- old/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/commons/xmlutil/Converter.java 2015-09-19 13:16:11.028970750 +0300
+++ new/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/commons/xmlutil/Converter.java 2015-09-19 13:16:10.880970017 +0300
@@ -198,7 +198,7 @@
* Wraps {@link javax.xml.stream.XMLStreamWriter} by an indentation engine if possible.
*
*
- * We can do this only when we have stax-utils.jar in the class path.
+ * We can do this only when we have {@code stax-utils.jar} in the class path.
*/
private static XMLStreamWriter createIndenter(XMLStreamWriter writer) {
try {
--- old/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/developer/JAXWSProperties.java 2015-09-19 13:16:11.532973250 +0300
+++ new/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/developer/JAXWSProperties.java 2015-09-19 13:16:11.384972516 +0300
@@ -148,7 +148,7 @@
public static final String WSENDPOINT = "com.sun.xml.internal.ws.api.server.WSEndpoint";
/**
- * Gets the wsa:To header.
+ * Gets the {@code wsa:To} header.
*
* The propery value is available on incoming SOAP message. The type of the value
* is {@link WSEndpointReference}.
@@ -160,7 +160,7 @@
public static final String ADDRESSING_TO = "com.sun.xml.internal.ws.api.addressing.to";
/**
- * Gets the wsa:From header.
+ * Gets the {@code wsa:From} header.
*
* The propery value is available on incoming SOAP message. The type of the value
* is {@link WSEndpointReference}.
@@ -172,7 +172,7 @@
public static final String ADDRESSING_FROM = "com.sun.xml.internal.ws.api.addressing.from";
/**
- * Gets the wsa:Action header value.
+ * Gets the {@code wsa:Action} header value.
*
* The propery value is available on incoming SOAP message. The type of the value
* is {@link String}.
@@ -184,7 +184,7 @@
public static final String ADDRESSING_ACTION = "com.sun.xml.internal.ws.api.addressing.action";
/**
- * Gets the wsa:MessageID header value.
+ * Gets the {@code wsa:MessageID} header value.
*
* The propery value is available on incoming SOAP message. The type of the value
* is {@link String}.
--- old/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/message/AbstractHeaderImpl.java 2015-09-19 13:16:12.032975729 +0300
+++ new/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/message/AbstractHeaderImpl.java 2015-09-19 13:16:11.888975015 +0300
@@ -128,7 +128,7 @@
}
/**
- * Parses a string that looks like xs:boolean into boolean.
+ * Parses a string that looks like {@code xs:boolean} into boolean.
*
* This method assumes that the whilespace normalization has already taken place.
*/
--- old/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/message/jaxb/JAXBMessage.java 2015-09-19 13:16:12.536978228 +0300
+++ new/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/message/jaxb/JAXBMessage.java 2015-09-19 13:16:12.392977514 +0300
@@ -186,7 +186,7 @@
* Creates a {@link Message} backed by a JAXB bean.
*
* @param bridge
- * Specify the payload tag name and how jaxbObject is bound.
+ * Specify the payload tag name and how {@code jaxbObject} is bound.
* @param jaxbObject
*/
public static Message create(XMLBridge bridge, Object jaxbObject, SOAPVersion soapVer) {
--- old/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/model/ParameterImpl.java 2015-09-19 13:16:13.036980708 +0300
+++ new/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/model/ParameterImpl.java 2015-09-19 13:16:12.900980033 +0300
@@ -161,7 +161,7 @@
}
/**
- * @return true if this instanceof {@link WrapperParameter} .
+ * @return true if {@code this instanceof} {@link WrapperParameter}.
*/
public boolean isWrapperStyle() {
return false;
@@ -223,7 +223,7 @@
*
* {@link JavaMethodImpl#getResponseParameters()} is guaranteed to have
* at most one such {@link ParameterImpl}. Note that there coule be none,
- * in which case the method returns void .
+ * in which case the method returns {@code void}.
*/
public boolean isResponse() {
return index == -1;
--- old/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/policy/privateutil/PolicyUtils.java 2015-09-19 13:16:13.544983227 +0300
+++ new/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/policy/privateutil/PolicyUtils.java 2015-09-19 13:16:13.396982493 +0300
@@ -401,7 +401,7 @@
*
* This method transforms the name of the given service class into a
* provider-configuration filename as described above and then uses the
- * getResources method of the given class loader to find all
+ * {@code getResources} method of the given class loader to find all
* available files with that name. These files are then read and parsed to
* produce a list of provider-class names. Eventually each provider class is
* instantiated and array of those instances is returned.
@@ -412,7 +412,7 @@
*
* @param serviceClass The service's abstract service class. Must not be {@code null}.
* @param loader The class loader to be used to load provider-configuration files
- * and instantiate provider classes, or null if the system
+ * and instantiate provider classes, or {@code null} if the system
* class loader (or, failing that the bootstrap class loader) is to
* be used
* @throws NullPointerException in case {@code service} input parameter is {@code null}.
--- old/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/policy/privateutil/ServiceFinder.java 2015-09-19 13:16:14.044985706 +0300
+++ new/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/policy/privateutil/ServiceFinder.java 2015-09-19 13:16:13.904985012 +0300
@@ -66,12 +66,12 @@
* zero-argument constructor so that they may be instantiated during lookup.
*
* A service provider identifies itself by placing a provider-configuration
- * file in the resource directory META-INF/services . The file's name
+ * file in the resource directory {@code META-INF/services}. The file's name
* should consist of the fully-qualified name of the abstract service class.
* The file should contain a list of fully-qualified concrete provider-class
* names, one per line. Space and tab characters surrounding each name, as
- * well as blank lines, are ignored. The comment character is '#'
- * (0x23 ); on each line all characters following the first comment
+ * well as blank lines, are ignored. The comment character is {@code '#'}
+ * ({@code 0x23}); on each line all characters following the first comment
* character are ignored. The file must be encoded in UTF-8.
*
* If a particular concrete provider class is named in more than one
@@ -83,20 +83,20 @@
* note that this is not necessarily the class loader that found the file.
*
* Example: Suppose we have a service class named
- * java.io.spi.CharCodec . It has two abstract methods:
+ * {@code java.io.spi.CharCodec}. It has two abstract methods:
*
*
* public abstract CharEncoder getEncoder(String encodingName);
* public abstract CharDecoder getDecoder(String encodingName);
*
*
- * Each method returns an appropriate object or null if it cannot
- * translate the given encoding. Typical CharCodec providers will
+ * Each method returns an appropriate object or {@code null} if it cannot
+ * translate the given encoding. Typical {@code CharCodec} providers will
* support more than one encoding.
*
- * If sun.io.StandardCodec is a provider of the CharCodec
+ *
If {@code sun.io.StandardCodec} is a provider of the {@code CharCodec}
* service then its jar file would contain the file
- * META-INF/services/java.io.spi.CharCodec . This file would contain
+ * {@code META-INF/services/java.io.spi.CharCodec}. This file would contain
* the single line:
*
*
@@ -139,7 +139,7 @@
*
* This method transforms the name of the given service class into a
* provider-configuration filename as described above and then uses the
- * getResources method of the given class loader to find all
+ * {@code getResources} method of the given class loader to find all
* available files with that name. These files are then read and parsed to
* produce a list of provider-class names. The iterator that is returned
* uses the given class loader to lookup and then instantiate each element
@@ -151,7 +151,7 @@
*
* @param service The service's abstract service class
* @param loader The class loader to be used to load provider-configuration files
- * and instantiate provider classes, or null if the system
+ * and instantiate provider classes, or {@code null} if the system
* class loader (or, failing that the bootstrap class loader) is to
* be used
* @throws ServiceConfigurationError If a provider-configuration file violates the specified format
@@ -193,9 +193,9 @@
/**
* Returns discovered objects incrementally.
*
- * @return An Iterator that yields provider objects for the given
+ * @return An {@code Iterator} that yields provider objects for the given
* service, in some arbitrary order. The iterator will throw a
- * ServiceConfigurationError if a provider-configuration
+ * {@code ServiceConfigurationError} if a provider-configuration
* file violates the specified format or if a provider class cannot
* be found and instantiated.
*/
@@ -284,8 +284,8 @@
* @param u The URL naming the configuration file to be parsed
* @param returned A Set containing the names of provider classes that have already
* been returned. This set will be updated to contain the names
- * that will be yielded from the returned Iterator .
- * @return A (possibly empty) Iterator that will yield the
+ * that will be yielded from the returned {@code Iterator}.
+ * @return A (possibly empty) {@code Iterator} that will yield the
* provider-class names in the given configuration file that are
* not yet members of the returned set
* @throws ServiceConfigurationError If an I/O error occurs while reading from the given URL, or
--- old/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/policy/sourcemodel/PolicySourceModel.java 2015-09-19 13:16:14.548988205 +0300
+++ new/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/policy/sourcemodel/PolicySourceModel.java 2015-09-19 13:16:14.412987531 +0300
@@ -299,7 +299,7 @@
* Every source model that references other policies must be expanded before it can be translated into a Policy objects. See
* {@link #expand(PolicySourceModelContext)} and {@link #isExpanded()} for more details.
*
- * @return {@code true} or {code false} depending on whether this policy source model contains references to another policy source models.
+ * @return {@code true} or {@code false} depending on whether this policy source model contains references to another policy source models.
*/
public boolean containsPolicyReferences() {
return !references.isEmpty();
--- old/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/server/sei/EndpointValueSetter.java 2015-09-19 13:16:15.064990764 +0300
+++ new/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/server/sei/EndpointValueSetter.java 2015-09-19 13:16:14.908989990 +0300
@@ -53,10 +53,10 @@
* @param obj
* The unmarshalled object.
* @param args
- * The arguments that need to be given to the Java method invocation. If obj
- * is supposed to be returned as a {@link Holder} value, a suitable
- * {@link Holder} is obtained from this argument list and obj
- * is set.
+ * The arguments that need to be given to the Java method invocation.
+ * If {@code obj} is supposed to be returned as a {@link Holder}
+ * value, a suitable {@link Holder} is obtained from
+ * this argument list and {@code obj} is set.
*
*/
abstract void put(Object obj, Object[] args);
--- old/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/spi/db/BindingContext.java 2015-09-19 13:16:15.576993303 +0300
+++ new/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/spi/db/BindingContext.java 2015-09-19 13:16:15.420992529 +0300
@@ -257,7 +257,7 @@
/**
* The property that you can specify to {@link JAXBContext#newInstance}
- * to allow unmarshaller to honor xsi:nil anywhere, even if they are
+ * to allow unmarshaller to honor {@code xsi:nil} anywhere, even if they are
* not specifically allowed by the schema.
*
* @since 2.1.3
--- old/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/spi/db/BindingHelper.java 2015-09-19 13:16:16.064995723 +0300
+++ new/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/spi/db/BindingHelper.java 2015-09-19 13:16:15.932995068 +0300
@@ -69,7 +69,7 @@
* Accordingly, this method may return an identifier that collides with reserved words.
*
*
- * Use JJavaName.isJavaIdentifier(String) to check for such collision.
+ * Use {@code JJavaName.isJavaIdentifier(String)} to check for such collision.
*
* @return
* Typically, this method returns "nameLikeThis".
@@ -111,17 +111,17 @@
*
*
* For example, given the following
- *
<![CDATA[
+ * <pre>{@code
* interface Foo<T> extends List<List<T>> {}
* interface Bar extends Foo<String> {}
- * ]]>
* This method works like this:
- * <![CDATA[
+ * <pre>{@code
* getBaseClass( Bar, List ) = List<List<String>
* getBaseClass( Bar, Foo ) = Foo<String>
* getBaseClass( Foo<? extends Number>, Collection ) = Collection<List<? extends Number>>
* getBaseClass( ArrayList<? extends BigInteger>, List ) = List<? extends BigInteger>
- * ]]>
* This parameter is usually exposed to {@link WebServiceContext}
* as {@link Packet#OUTBOUND_TRANSPORT_HEADERS}, and thus it
- * should ignore Content-Type and Content-Length headers.
+ * should ignore {@code Content-Type} and {@code Content-Length} headers.
*
* @param headers
* See {@link HttpURLConnection#getHeaderFields()} for the format.
@@ -105,7 +105,7 @@
public abstract void setResponseHeader(String key, List value);
/**
- * Sets the "Content-Type" header.
+ * Sets the {@code "Content-Type"} header.
*
*
* If the Content-Type header has already been set, this method will overwrite
@@ -116,8 +116,8 @@
* may be invoked in any arbitrary order.
*
* @param value
- * strings like "application/xml; charset=UTF-8" or
- * "image/jpeg" .
+ * strings like {@code "application/xml; charset=UTF-8"} or
+ * {@code "image/jpeg"}.
*/
public abstract void setContentTypeResponseHeader(@NotNull String value);
--- old/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/transport/http/server/ServerAdapter.java 2015-09-19 13:16:17.069000701 +0300
+++ new/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/transport/http/server/ServerAdapter.java 2015-09-19 13:16:16.920999967 +0300
@@ -69,7 +69,7 @@
}
/**
- * Gets the name of the endpoint as given in the sun-jaxws.xml
+ * Gets the name of the endpoint as given in the {@code sun-jaxws.xml}
* deployment descriptor.
*/
public String getName() {
--- old/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/util/QNameMap.java 2015-09-19 13:16:17.565003161 +0300
+++ new/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/util/QNameMap.java 2015-09-19 13:16:17.425002467 +0300
@@ -128,12 +128,12 @@
/**
* Returns the value to which the specified keys are mapped in this QNameMap,
- * or null if the map contains no mapping for this key.
+ * or {@code null} if the map contains no mapping for this key.
*
* @param nsUri the namespaceUri key whose associated value is to be returned.
* @param localPart the localPart key whose associated value is to be returned.
* @return the value to which this map maps the specified set of keya, or
- * null if the map contains no mapping for this set of keys.
+ * {@code null} if the map contains no mapping for this set of keys.
* @see #put(String,String, Object)
*/
public V get( @NotNull String nsUri, String localPart ) {
--- old/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/util/ServiceFinder.java 2015-09-19 13:16:18.065005640 +0300
+++ new/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/util/ServiceFinder.java 2015-09-19 13:16:17.925004946 +0300
@@ -76,12 +76,12 @@
* zero-argument constructor so that they may be instantiated during lookup.
*
* A service provider identifies itself by placing a provider-configuration
- * file in the resource directory META-INF/services . The file's name
+ * file in the resource directory {@code META-INF/services}. The file's name
* should consist of the fully-qualified name of the abstract service class.
* The file should contain a list of fully-qualified concrete provider-class
* names, one per line. Space and tab characters surrounding each name, as
- * well as blank lines, are ignored. The comment character is '#'
- * (0x23 ); on each line all characters following the first comment
+ * well as blank lines, are ignored. The comment character is {@code '#'}
+ * ({@code 0x23}); on each line all characters following the first comment
* character are ignored. The file must be encoded in UTF-8.
*
* If a particular concrete provider class is named in more than one
@@ -93,20 +93,20 @@
* note that this is not necessarily the class loader that found the file.
*
* Example: Suppose we have a service class named
- * java.io.spi.CharCodec . It has two abstract methods:
+ * {@code java.io.spi.CharCodec}. It has two abstract methods:
*
*
* public abstract CharEncoder getEncoder(String encodingName);
* public abstract CharDecoder getDecoder(String encodingName);
*
*
- * Each method returns an appropriate object or null if it cannot
- * translate the given encoding. Typical CharCodec providers will
+ * Each method returns an appropriate object or {@code null} if it cannot
+ * translate the given encoding. Typical {@code CharCodec} providers will
* support more than one encoding.
*
- * If sun.io.StandardCodec is a provider of the CharCodec
+ *
If {@code sun.io.StandardCodec} is a provider of the {@code CharCodec}
* service then its jar file would contain the file
- * META-INF/services/java.io.spi.CharCodec . This file would contain
+ * {@code META-INF/services/java.io.spi.CharCodec}. This file would contain
* the single line:
*
*
@@ -169,7 +169,7 @@
*
* This method transforms the name of the given service class into a
* provider-configuration filename as described above and then uses the
- * getResources method of the given class loader to find all
+ * {@code getResources} method of the given class loader to find all
* available files with that name. These files are then read and parsed to
* produce a list of provider-class names. The iterator that is returned
* uses the given class loader to lookup and then instantiate each element
@@ -181,7 +181,7 @@
*
* @param service The service's abstract service class
* @param loader The class loader to be used to load provider-configuration files
- * and instantiate provider classes, or null if the system
+ * and instantiate provider classes, or {@code null} if the system
* class loader (or, failing that the bootstrap class loader) is to
* be used
* @throws ServiceConfigurationError If a provider-configuration file violates the specified format
@@ -227,9 +227,9 @@
/**
* Returns discovered objects incrementally.
*
- * @return An Iterator that yields provider objects for the given
+ * @return An {@code Iterator} that yields provider objects for the given
* service, in some arbitrary order. The iterator will throw a
- * ServiceConfigurationError if a provider-configuration
+ * {@code ServiceConfigurationError} if a provider-configuration
* file violates the specified format or if a provider class cannot
* be found and instantiated.
*/
@@ -319,8 +319,8 @@
* @param u The URL naming the configuration file to be parsed
* @param returned A Set containing the names of provider classes that have already
* been returned. This set will be updated to contain the names
- * that will be yielded from the returned Iterator .
- * @return A (possibly empty) Iterator that will yield the
+ * that will be yielded from the returned {@code Iterator}.
+ * @return A (possibly empty) {@code Iterator} that will yield the
* provider-class names in the given configuration file that are
* not yet members of the returned set
* @throws ServiceConfigurationError If an I/O error occurs while reading from the given URL, or
--- old/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/util/pipe/DumpTube.java 2015-09-19 13:16:18.593008259 +0300
+++ new/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/util/pipe/DumpTube.java 2015-09-19 13:16:18.437007485 +0300
@@ -119,7 +119,7 @@
* Wraps {@link XMLStreamWriter} by an indentation engine if possible.
*
*
- * We can do this only when we have stax-utils.jar in the classpath.
+ * We can do this only when we have {@code stax-utils.jar} in the classpath.
*/
private XMLStreamWriter createIndenter(XMLStreamWriter writer) {
try {
--- old/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/wsdl/parser/RuntimeWSDLParser.java 2015-09-19 13:16:19.093010738 +0300
+++ new/src/java.xml.ws/share/classes/com/sun/xml/internal/ws/wsdl/parser/RuntimeWSDLParser.java 2015-09-19 13:16:18.945010004 +0300
@@ -139,7 +139,7 @@
* then as last option, if the wsdlLoc has no '?wsdl' as query parameter then it is tried by appending '?wsdl'.
*
* @param wsdlLoc
- * Either this or wsdl parameter must be given.
+ * Either this or {@code wsdl} parameter must be given.
* Null location means the system won't be able to resolve relative references in the WSDL,
*/
public static WSDLModel parse(@Nullable URL wsdlLoc, @NotNull Source wsdlSource, @NotNull EntityResolver resolver,
@@ -154,7 +154,7 @@
* then as last option, if the wsdlLoc has no '?wsdl' as query parameter then it is tried by appending '?wsdl'.
*
* @param wsdlLoc
- * Either this or wsdl parameter must be given.
+ * Either this or {@code wsdl} parameter must be given.
* Null location means the system won't be able to resolve relative references in the WSDL,
*/
public static WSDLModel parse(@Nullable URL wsdlLoc, @NotNull Source wsdlSource, @NotNull EntityResolver resolver,
@@ -169,7 +169,7 @@
* then as last option, if the wsdlLoc has no '?wsdl' as query parameter then it is tried by appending '?wsdl'.
*
* @param wsdlLoc
- * Either this or wsdl parameter must be given.
+ * Either this or {@code wsdl} parameter must be given.
* Null location means the system won't be able to resolve relative references in the WSDL,
*/
public static WSDLModel parse(@Nullable URL wsdlLoc, @NotNull Source wsdlSource, @NotNull EntityResolver resolver,
@@ -184,7 +184,7 @@
* then as last option, if the wsdlLoc has no '?wsdl' as query parameter then it is tried by appending '?wsdl'.
*
* @param wsdlLoc
- * Either this or wsdl parameter must be given.
+ * Either this or {@code wsdl} parameter must be given.
* Null location means the system won't be able to resolve relative references in the WSDL,
*/
public static WSDLModel parse(@Nullable URL wsdlLoc, @NotNull Source wsdlSource, @NotNull EntityResolver resolver,
@@ -200,7 +200,7 @@
* then as last option, if the wsdlLoc has no '?wsdl' as query parameter then it is tried by appending '?wsdl'.
*
* @param wsdlLoc
- * Either this or wsdl parameter must be given.
+ * Either this or {@code wsdl} parameter must be given.
* Null location means the system won't be able to resolve relative references in the WSDL,
*/
public static WSDLModel parse(@Nullable URL wsdlLoc, @NotNull Source wsdlSource, @NotNull EntityResolver resolver,
--- old/src/java.xml.ws/share/classes/javax/xml/soap/SOAPException.java 2015-09-19 13:16:19.617013336 +0300
+++ new/src/java.xml.ws/share/classes/javax/xml/soap/SOAPException.java 2015-09-19 13:16:19.473012622 +0300
@@ -141,7 +141,7 @@
* @param cause the {@code Throwable} object that caused this
* {@code SOAPException} object to be thrown. The value of this
* parameter is saved for later retrieval by the
- * {@link #getCause()} method. A null value is
+ * {@link #getCause()} method. A {@code null} value is
* permitted and indicates that the cause is nonexistent or
* unknown.
* @return a reference to this {@code SOAPException} instance
--- old/src/java.xml.ws/share/classes/javax/xml/ws/WebServiceException.java 2015-09-19 13:16:20.105015756 +0300
+++ new/src/java.xml.ws/share/classes/javax/xml/ws/WebServiceException.java 2015-09-19 13:16:19.965015062 +0300
@@ -62,13 +62,14 @@
}
/** Constructs a new WebServiceException with the specified cause
- * and a detail message of (cause==null ? null :
- * cause.toString()) (which typically contains the
- * class and detail message of cause ).
+ * and a detail message of
+ * {@code (cause==null ? null : cause.toString())}
+ * (which typically contains the
+ * class and detail message of {@code cause}).
*
* @param cause The cause which is saved for the later
* retrieval throw by the getCause method.
- * (A null value is permitted, and
+ * (A {@code null} value is permitted, and
* indicates that the cause is nonexistent or
* unknown.)
**/
--- old/src/java.xml.ws/share/classes/javax/xml/ws/spi/http/HttpExchange.java 2015-09-19 13:16:20.601018216 +0300
+++ new/src/java.xml.ws/share/classes/javax/xml/ws/spi/http/HttpExchange.java 2015-09-19 13:16:20.461017521 +0300
@@ -259,7 +259,7 @@
* It is the path that comes
* after the web service path but before the query string in the
* request URI
- * null if there is no extra path in the request URI
+ * {@code null} if there is no extra path in the request URI
*/
public abstract String getPathInfo();
@@ -271,7 +271,7 @@
* This can be used for {@link MessageContext#QUERY_STRING}
*
* @return undecoded query string of request URI, or
- * null if the request URI doesn't have one
+ * {@code null} if the request URI doesn't have one
*/
public abstract String getQueryString();
@@ -292,7 +292,7 @@
* be exposed using {@link #REQUEST_X509CERTIFICATE}
*
* @param name attribute name
- * @return the attribute value, or null if the attribute doesn't
+ * @return the attribute value, or {@code null} if the attribute doesn't
* exist
*/
public abstract Object getAttribute(String name);
@@ -311,7 +311,7 @@
* user for this {@code HttpExchange}.
*
* @return Principal for an authenticated user, or
- * null if not authenticated
+ * {@code null} if not authenticated
*/
public abstract Principal getUserPrincipal();
@@ -320,7 +320,7 @@
* logical "role".
*
* @param role specifies the name of the role
- * @return true if the user making this request belongs to a
+ * @return {@code true} if the user making this request belongs to a
* given role
*/
public abstract boolean isUserInRole(String role);
--- old/src/jdk.xml.bind/share/classes/com/sun/codemodel/internal/JClass.java 2015-09-19 13:16:21.101020695 +0300
+++ new/src/jdk.xml.bind/share/classes/com/sun/codemodel/internal/JClass.java 2015-09-19 13:16:20.957019981 +0300
@@ -51,7 +51,7 @@
* @return
* name of this class, without any qualification.
* For example, this method returns "String" for
- * java.lang.String.
+ * {@code java.lang.String}.
*/
abstract public String name();
@@ -62,7 +62,7 @@
abstract public JPackage _package();
/**
- * Returns the class in which this class is nested, or null if
+ * Returns the class in which this class is nested, or {@code null} if
* this is a top-level class.
*/
public JClass outer() {
@@ -102,7 +102,7 @@
*
*
* For example, if this {@link JClass} represents
- * Set<T>, this method returns an array
+ * {@code Set}, this method returns an array
* that contains single {@link JTypeVar} for 'T'.
*/
public JTypeVar[] typeParams() {
@@ -134,7 +134,7 @@
/**
* @deprecated calling this method from {@link JClass}
* would be meaningless, since it's always guaranteed to
- * return this .
+ * return {@code this}.
*/
public JClass boxify() { return this; }
@@ -184,17 +184,17 @@
*
*
* For example, given the following
- *
<![CDATA[
+ * <pre>{@code
* interface Foo<T> extends List<List<T>> {}
* interface Bar extends Foo<String> {}
- * ]]>
* This method works like this:
- * <![CDATA[
+ * <pre>{@code
* getBaseClass( Bar, List ) = List<List<String>
* getBaseClass( Bar, Foo ) = Foo<String>
* getBaseClass( Foo<? extends Number>, Collection ) = Collection<List<? extends Number>>
* getBaseClass( ArrayList<? extends BigInteger>, List ) = List<? extends BigInteger>
- * ]]>
- * .narrow(X) builds Set<X> from Set.
+ * {@code .narrow(X)} builds {@code Set} from {@code Set}.
*/
public JClass narrow( Class clazz ) {
return narrow(owner().ref(clazz));
@@ -259,7 +259,7 @@
* a type argument.
*
*
- * .narrow(X) builds Set<X> from Set.
+ * {@code .narrow(X)} builds {@code Set} from {@code Set}.
*/
public JClass narrow( JClass clazz ) {
return new JNarrowedClass(this,clazz);
@@ -307,7 +307,7 @@
* For example, when this class is Map<String,Map<V>>,
* (where V then doing
* substituteParams( V, Integer ) returns a {@link JClass}
- * for Map<String,Map<Integer>>.
+ * for {@code Map>}.
*
*
* This method needs to work recursively.
--- old/src/jdk.xml.bind/share/classes/com/sun/codemodel/internal/JClassContainer.java 2015-09-19 13:16:21.605023194 +0300
+++ new/src/jdk.xml.bind/share/classes/com/sun/codemodel/internal/JClassContainer.java 2015-09-19 13:16:21.465022500 +0300
@@ -129,7 +129,7 @@
* Gets the nearest package parent.
*
*
- * If this.isPackage() , then return this .
+ * If {@code this.isPackage()}, then return {@code this}.
*/
public JPackage getPackage();
--- old/src/jdk.xml.bind/share/classes/com/sun/codemodel/internal/JCodeModel.java 2015-09-19 13:16:22.093025614 +0300
+++ new/src/jdk.xml.bind/share/classes/com/sun/codemodel/internal/JCodeModel.java 2015-09-19 13:16:21.949024900 +0300
@@ -59,7 +59,7 @@
*
*
* Every CodeModel node is always owned by one {@link JCodeModel} object
- * at any given time (which can be often accesesd by the owner() method.)
+ * at any given time (which can be often accesesd by the {@code owner()} method.)
*
* As such, when you generate Java code, most of the operation works
* in a top-down fashion. For example, you create a class from {@link JCodeModel},
@@ -635,7 +635,7 @@
/**
* Conversion from primitive type {@link Class} (such as {@link Integer#TYPE}
- * to its boxed type (such as Integer.class )
+ * to its boxed type (such as {@code Integer.class})
*/
public static final Map,Class> primitiveToBox;
/**
--- old/src/jdk.xml.bind/share/classes/com/sun/codemodel/internal/JConditional.java 2015-09-19 13:16:22.605028153 +0300
+++ new/src/jdk.xml.bind/share/classes/com/sun/codemodel/internal/JConditional.java 2015-09-19 13:16:22.465027459 +0300
@@ -76,7 +76,7 @@
}
/**
- * Creates ... else if(...) ... code.
+ * Creates {@code ... else if(...) ...} code.
*/
public JConditional _elseif(JExpression boolExp) {
return _else()._if(boolExp);
--- old/src/jdk.xml.bind/share/classes/com/sun/codemodel/internal/JExpression.java 2015-09-19 13:16:23.093030573 +0300
+++ new/src/jdk.xml.bind/share/classes/com/sun/codemodel/internal/JExpression.java 2015-09-19 13:16:22.953029879 +0300
@@ -39,7 +39,7 @@
* which returns a complicated expression (by often taking other {@link JExpression}s
* as parameters.
* For example, you can build "5+2" by
- * JExpr.lit(5).add(JExpr.lit(2))
+ * {@code JExpr.lit(5).add(JExpr.lit(2))}
*/
public interface JExpression extends JGenerable {
/**
--- old/src/jdk.xml.bind/share/classes/com/sun/codemodel/internal/JExpressionImpl.java 2015-09-19 13:16:23.593033052 +0300
+++ new/src/jdk.xml.bind/share/classes/com/sun/codemodel/internal/JExpressionImpl.java 2015-09-19 13:16:23.449032338 +0300
@@ -40,7 +40,7 @@
}
/**
- * Logical not '!x' .
+ * Logical not {@code '!x'}.
*/
public final JExpression not() {
return JOp.not(this);
--- old/src/jdk.xml.bind/share/classes/com/sun/codemodel/internal/JOp.java 2015-09-19 13:16:24.085035492 +0300
+++ new/src/jdk.xml.bind/share/classes/com/sun/codemodel/internal/JOp.java 2015-09-19 13:16:23.945034798 +0300
@@ -77,7 +77,7 @@
}
/**
- * Logical not '!x' .
+ * Logical not {@code '!x'}.
*/
public static JExpression not(JExpression e) {
if (e == JExpr.TRUE) return JExpr.FALSE;
--- old/src/jdk.xml.bind/share/classes/com/sun/codemodel/internal/JPrimitiveType.java 2015-09-19 13:16:24.573037912 +0300
+++ new/src/jdk.xml.bind/share/classes/com/sun/codemodel/internal/JPrimitiveType.java 2015-09-19 13:16:24.441037257 +0300
@@ -81,7 +81,7 @@
/**
* @deprecated calling this method from {@link JPrimitiveType}
* would be meaningless, since it's always guaranteed to
- * return this .
+ * return {@code this}.
*/
public JType unboxify() {
return this;
--- old/src/jdk.xml.bind/share/classes/com/sun/codemodel/internal/JType.java 2015-09-19 13:16:25.061040332 +0300
+++ new/src/jdk.xml.bind/share/classes/com/sun/codemodel/internal/JType.java 2015-09-19 13:16:24.929039677 +0300
@@ -116,7 +116,8 @@
}
/**
- * If this class is a primitive type, return the boxed class. Otherwise return this .
+ * If this class is a primitive type, return the boxed class.
+ * Otherwise return {@code this}.
*
*
* For example, for "int", this method returns "java.lang.Integer".
@@ -125,7 +126,7 @@
/**
* If this class is a wrapper type for a primitive, return the primitive type.
- * Otherwise return this .
+ * Otherwise return {@code this}.
*
*
* For example, for "java.lang.Integer", this method returns "int".
--- old/src/jdk.xml.bind/share/classes/com/sun/istack/internal/tools/ParallelWorldClassLoader.java 2015-09-19 13:16:25.577042890 +0300
+++ new/src/jdk.xml.bind/share/classes/com/sun/istack/internal/tools/ParallelWorldClassLoader.java 2015-09-19 13:16:25.421042117 +0300
@@ -57,9 +57,9 @@
* +- X.class
*
*
- * {@link ParallelWorldClassLoader}("foo/") would load X.class from
- * /foo/X.class (note that X is defined in the root package, not
- * foo.X .
+ * {@link ParallelWorldClassLoader}("foo/") would load {@code X.class} from
+ * {@code /foo/X.class} (note that X is defined in the root package, not
+ * {@code foo.X}.
*
*
* This can be combined with {@link MaskingClassLoader} to mask classes which are loaded by the parent
@@ -77,11 +77,13 @@
* +- X.class
*
*
- * {@link ParallelWorldClassLoader}(MaskingClassLoader.class.getClassLoader()) would load foo.X.class from
- * /bar/foo.X.class not the foo.X.class in the publicly visible place in the jar file, thus
- * masking the parent classLoader from loading the class from foo.X.class
+ * {@link ParallelWorldClassLoader}(MaskingClassLoader.class.getClassLoader())
+ * would load {@code foo.X.class} from
+ * {@code /bar/foo.X.class} not the {@code foo.X.class}
+ * in the publicly visible place in the jar file, thus
+ * masking the parent classLoader from loading the class from {@code foo.X.class}
* (note that X is defined in the package foo, not
- * bar.foo.X .
+ * {@code bar.foo.X}.
*
* @author Kohsuke Kawaguchi
*/
--- old/src/jdk.xml.bind/share/classes/com/sun/tools/internal/jxc/SchemaGenerator.java 2015-09-19 13:16:26.069045330 +0300
+++ new/src/jdk.xml.bind/share/classes/com/sun/tools/internal/jxc/SchemaGenerator.java 2015-09-19 13:16:25.929044636 +0300
@@ -182,8 +182,8 @@
}
/**
- * Computes the file system path of jaxb-api.jar so that
- * Annotation Processing will see them in the -cp option.
+ * Computes the file system path of {@code jaxb-api.jar} so that
+ * Annotation Processing will see them in the {@code -cp} option.
*
*
* In Java, you can't do this reliably (for that matter there's no guarantee
--- old/src/jdk.xml.bind/share/classes/com/sun/tools/internal/jxc/gen/config/NGCCInterleaveFilter.java 2015-09-19 13:16:26.585047889 +0300
+++ new/src/jdk.xml.bind/share/classes/com/sun/tools/internal/jxc/gen/config/NGCCInterleaveFilter.java 2015-09-19 13:16:26.433047135 +0300
@@ -74,14 +74,14 @@
//
/**
* Receiver that is being locked and therefore receives all the events.
- *
<![CDATA[
+ * <pre>{@code
* <interleave>
* <element name="foo"/>
* <element name="bar">
* <element name="foo"/>
* </element>
* </interlaeve>
- * ]]> <![CDATA[
+ * <pre>{@code
* <element name="foo">
* <choice>
* <element name="bar"><empty/></element>
* <text/>
* </choice>
* </element>
- * ]]>
+ * }
*
* Assume we hit the following instance:
- * <![CDATA[
+ * <pre>{@code
* <foo> <bar/></foo>
- * ]]>
+ * }
*
* Then this first space needs to be ignored (for otherwise, we will
* end up treating this space as the match to <text/> and won't
* be able to process <bar>.)
*
* Now assume the following instance:
- * <![CDATA[
+ * <pre>{@code
* <foo/>
- * ]]>
+ * }
*
* This time, we need to treat this empty string as a text, for
* otherwise we won't be able to accept this instance.
@@ -483,16 +483,16 @@
* the top of the effective bindings. Because of the
* timing difference between the startPrefixMapping method
* and the execution of the corresponding actions,
- * this value can be different from namespaces.size().
+ * this value can be different from {@code namespaces.size()}.
*
* For example, consider the following schema:
- *
<![CDATA[
+ * <pre>{@code
* <oneOrMore>
* <element name="foo"><empty/></element>
* </oneOrMore>
* code fragment X
* <element name="bob"/>
- * ]]> STRICT
- * or EXTENSION.
+ * the compatibility rules in the spec. Either {@code STRICT}
+ * or {@code EXTENSION}.
*/
public int compatibilityMode = STRICT;
@@ -187,7 +187,7 @@
public EntityResolver entityResolver = null;
/**
- * Type of input schema language. One of the SCHEMA_XXX
+ * Type of input schema language. One of the {@code SCHEMA_XXX}
* constants.
*/
private Language schemaLanguage = null;
@@ -466,7 +466,7 @@
/**
- * Parses an option args[i] and return
+ * Parses an option {@code args[i]} and return
* the number of tokens consumed.
*
* @return
@@ -842,7 +842,7 @@
}
/**
- * Finds the META-INF/sun-jaxb.episode file to add as a binding customization.
+ * Finds the {@code META-INF/sun-jaxb.episode} file to add as a binding customization.
*/
public void scanEpisodeFile(File jar) throws BadCommandLineException {
try {
--- old/src/jdk.xml.bind/share/classes/com/sun/tools/internal/xjc/api/JavaCompiler.java 2015-09-19 13:16:28.093055367 +0300
+++ new/src/jdk.xml.bind/share/classes/com/sun/tools/internal/xjc/api/JavaCompiler.java 2015-09-19 13:16:27.953054672 +0300
@@ -59,10 +59,10 @@
* @param additionalElementDecls
* Add element declarations for the specified element names to
* the XML types mapped from the corresponding {@link Reference}s.
- * Those {@link Reference}s must be included in the rootTypes parameter.
+ * Those {@link Reference}s must be included in the {@code rootTypes} parameter.
* In this map, a {@link Reference} can be null, in which case the element name is
* declared to have an empty complex type.
- * (<xs:element name='foo'><xs:complexType/></xs:element>)
+ * ({@code ObjectFactory classes generated by the compilation.
+ * Gets all the {@code ObjectFactory} classes generated by the compilation.
*
*
* This should be used for generating {@link XmlSeeAlso} on the SEI.
--- old/src/jdk.xml.bind/share/classes/com/sun/tools/internal/xjc/api/SchemaCompiler.java 2015-09-19 13:16:29.073060226 +0300
+++ new/src/jdk.xml.bind/share/classes/com/sun/tools/internal/xjc/api/SchemaCompiler.java 2015-09-19 13:16:28.933059532 +0300
@@ -57,7 +57,7 @@
*
* The caller can feed the following synthesized schema
* to achive the namespace URI -> Java package customization:
- *
<![CDATA[
+ * <pre>{@code
* <schema targetNamespace="xml.namespace.uri"
* xmlns="http://www.w3.org/2001/XMLSchema"
* xmlns:jaxb="http://java.sun.com/xml/ns/jaxb"
@@ -68,7 +68,7 @@
* </jaxb:schemaBindings>
* </appinfo></annotation>
* </schema>
- * ]]>
* In general, a property often has to be capable of representing null
* to indicate the absence of the value. This requires properties
- * to be generated as @XmlElement Float f , not as
- * @XmlElement float f; . But this is slow.
+ * to be generated as {@code @XmlElement Float f}, not as
+ * {@code @XmlElement float f;}. But this is slow.
*
*
* Fortunately, there are cases where we know that the property can
--- old/src/jdk.xml.bind/share/classes/com/sun/tools/internal/xjc/model/TypeUse.java 2015-09-19 13:16:30.061065126 +0300
+++ new/src/jdk.xml.bind/share/classes/com/sun/tools/internal/xjc/model/TypeUse.java 2015-09-19 13:16:29.921064431 +0300
@@ -88,7 +88,7 @@
* Creates a constant for the given lexical value.
*
*
- * For example, to create a constant 1 for xs:int , you'd do:
+ * For example, to create a constant 1 for {@code xs:int}, you'd do:
*
* CBuiltinLeafInfo.INT.createConstant( codeModel, "1", null );
*
--- old/src/jdk.xml.bind/share/classes/com/sun/tools/internal/xjc/outline/FieldAccessor.java 2015-09-19 13:16:30.573067664 +0300
+++ new/src/jdk.xml.bind/share/classes/com/sun/tools/internal/xjc/outline/FieldAccessor.java 2015-09-19 13:16:30.413066871 +0300
@@ -98,7 +98,7 @@
FieldOutline owner();
/**
- * Short for owner().getPropertyInfo()
+ * Short for {@code owner().getPropertyInfo()}
*/
CPropertyInfo getPropertyInfo();
}
--- old/src/jdk.xml.bind/share/classes/com/sun/tools/internal/xjc/reader/gbind/Expression.java 2015-09-19 13:16:31.069070124 +0300
+++ new/src/jdk.xml.bind/share/classes/com/sun/tools/internal/xjc/reader/gbind/Expression.java 2015-09-19 13:16:30.925069410 +0300
@@ -35,12 +35,12 @@
public abstract class Expression {
/**
- * Computes LAST(exp)
+ * Computes {@code LAST(exp)}
*/
abstract ElementSet lastSet();
/**
- * True of \epsilon \in L(exp)
+ * True of {@code \epsilon \in L(exp)}
*/
abstract boolean isNullable();
--- old/src/jdk.xml.bind/share/classes/com/sun/tools/internal/xjc/reader/internalizer/ContentHandlerNamespacePrefixAdapter.java 2015-09-19 13:16:31.569072603 +0300
+++ new/src/jdk.xml.bind/share/classes/com/sun/tools/internal/xjc/reader/internalizer/ContentHandlerNamespacePrefixAdapter.java 2015-09-19 13:16:31.425071889 +0300
@@ -37,13 +37,13 @@
/**
* {@link XMLReader} filter for supporting
- * http://xml.org/sax/features/namespace-prefixes feature.
+ * {@code http://xml.org/sax/features/namespace-prefixes} feature.
*
* @author Kohsuke Kawaguchi
*/
final class ContentHandlerNamespacePrefixAdapter extends XMLFilterImpl {
/**
- * True if http://xml.org/sax/features/namespace-prefixes is set to true.
+ * True if {@code http://xml.org/sax/features/namespace-prefixes} is set to true.
*/
private boolean namespacePrefixes = false;
--- old/src/jdk.xml.bind/share/classes/com/sun/tools/internal/xjc/reader/internalizer/SCDBasedBindingSet.java 2015-09-19 13:16:32.073075103 +0300
+++ new/src/jdk.xml.bind/share/classes/com/sun/tools/internal/xjc/reader/internalizer/SCDBasedBindingSet.java 2015-09-19 13:16:31.917074329 +0300
@@ -72,10 +72,10 @@
/**
* SCDs can be specified via multiple steps, like:
*
- * <![CDATA[
+ * <pre>{@code
* <bindings scd="foo/bar">
* <bindings scd="zot/xyz">
- * ]]>
+ * }
*
* This field and {@link #nextSibling} form a single-linked list that
* represent the children that shall be evaluated within this target.
--- old/src/jdk.xml.bind/share/classes/com/sun/tools/internal/xjc/reader/xmlschema/ClassSelector.java 2015-09-19 13:16:32.565077542 +0300
+++ new/src/jdk.xml.bind/share/classes/com/sun/tools/internal/xjc/reader/xmlschema/ClassSelector.java 2015-09-19 13:16:32.429076868 +0300
@@ -281,7 +281,7 @@
* the binding of the body will be done later, to avoid
* cyclic binding problem.
* @param referer
- * The component that refers to sc . This can be null,
+ * The component that refers to {@code sc}. This can be null,
* if figuring out the referer is too hard, in which case
* the error message might be less user friendly.
*/
@@ -423,7 +423,7 @@
/**
- * Set of package names that are tested (set of Strings.)
+ * Set of package names that are tested (set of {@code String}s.)
*
* This set is used to avoid duplicating "incorrect package name"
* errors.
--- old/src/jdk.xml.bind/share/classes/com/sun/tools/internal/xjc/reader/xmlschema/GWildcardElement.java 2015-09-19 13:16:33.065080022 +0300
+++ new/src/jdk.xml.bind/share/classes/com/sun/tools/internal/xjc/reader/xmlschema/GWildcardElement.java 2015-09-19 13:16:32.925079327 +0300
@@ -36,7 +36,7 @@
final class GWildcardElement extends GElement {
/**
- * If true, bind to Object for eager JAXB unmarshalling.
+ * If true, bind to {@code Object} for eager JAXB unmarshalling.
* Otherwise bind to DOM (I hate "you can put both" semantics,
* so I'm not going to do that in this binding mode.)
*/
--- old/src/jdk.xml.bind/share/classes/com/sun/tools/internal/xjc/reader/xmlschema/UnusedCustomizationChecker.java 2015-09-19 13:16:33.557082461 +0300
+++ new/src/jdk.xml.bind/share/classes/com/sun/tools/internal/xjc/reader/xmlschema/UnusedCustomizationChecker.java 2015-09-19 13:16:33.421081787 +0300
@@ -65,7 +65,8 @@
*
*
* Since we scan the whole content tree, we use this to check for unused
- * xmime:expectedContentTypes attributes. TODO: if we find this kind of error checks more
+ * {@code xmime:expectedContentTypes} attributes.
+ * TODO: if we find this kind of error checks more
* common, use the visitors so that we don't have to mix everything in one class.
*
* @author
--- old/src/jdk.xml.bind/share/classes/com/sun/tools/internal/xjc/reader/xmlschema/bindinfo/BIFactoryMethod.java 2015-09-19 13:16:34.057084941 +0300
+++ new/src/jdk.xml.bind/share/classes/com/sun/tools/internal/xjc/reader/xmlschema/bindinfo/BIFactoryMethod.java 2015-09-19 13:16:33.909084207 +0300
@@ -36,7 +36,7 @@
import com.sun.tools.internal.xjc.reader.xmlschema.BGMBuilder;
/**
- * Controls the ObjectFactory method name.
+ * Controls the {@code ObjectFactory} method name.
*
* @author Kohsuke Kawaguchi
*/
--- old/src/jdk.xml.bind/share/classes/com/sun/tools/internal/xjc/reader/xmlschema/bindinfo/BIGlobalBinding.java 2015-09-19 13:16:34.569087480 +0300
+++ new/src/jdk.xml.bind/share/classes/com/sun/tools/internal/xjc/reader/xmlschema/bindinfo/BIGlobalBinding.java 2015-09-19 13:16:34.417086726 +0300
@@ -454,9 +454,9 @@
/**
* Used to unmarshal
- *
<![CDATA[
+ * <pre>{@code
* <[element] name="className" />
- * ]]>
+ * }
*/
static final class ClassNameBean {
@XmlAttribute(required=true)
--- old/src/jdk.xml.bind/share/classes/com/sun/tools/internal/xjc/runtime/ZeroOneBooleanAdapter.java 2015-09-19 13:16:35.081090019 +0300
+++ new/src/jdk.xml.bind/share/classes/com/sun/tools/internal/xjc/runtime/ZeroOneBooleanAdapter.java 2015-09-19 13:16:34.933089285 +0300
@@ -29,7 +29,7 @@
import javax.xml.bind.annotation.adapters.XmlAdapter;
/**
- * Serializes boolean as 0 or 1.
+ * Serializes {@code boolean} as 0 or 1.
*
* @author Kohsuke Kawaguchi
* @since 2.0
--- old/src/jdk.xml.bind/share/classes/com/sun/xml/internal/rngom/ast/builder/SchemaBuilder.java 2015-09-19 13:16:35.593092557 +0300
+++ new/src/jdk.xml.bind/share/classes/com/sun/xml/internal/rngom/ast/builder/SchemaBuilder.java 2015-09-19 13:16:35.437091784 +0300
@@ -111,13 +111,13 @@
* @param parent
* The parent scope. null if there's no parent scope.
* For example, if the complete document looks like the following:
- * <![CDATA[
+ * <pre>{@code
* <grammar>
* <start><element name="root"><empty/></element></start>
* </grammar>
- * ]]> null parent.
+ * receive the {@code null} parent.
*/
Grammar makeGrammar(Scope parent);
@@ -126,12 +126,12 @@
*
* such as,
*
- * <![CDATA[
+ * <pre>{@code
* <element name="foo"> <!-- this becomes 'P' -->
* <foreign:annotation /> <!-- this becomes 'A' -->
* ...
* </element>
- * ]]> <![CDATA[
+ * <pre>{@code
* <element name="foo">
* <empty /> <!-- this becomes 'P' -->
* <foreign:annotation /> <!-- this becomes 'E' -->
* </element>
- * ]]>
- * The checking is done by using the rngom.binary package, so if you are using
+ * The checking is done by using the {@code rngom.binary} package, so if you are using
* that package for parsing schemas, then there's no need to use this.
*
* @author
--- old/src/jdk.xml.bind/share/classes/com/sun/xml/internal/rngom/binary/package.html 2015-09-19 13:16:36.589097496 +0300
+++ new/src/jdk.xml.bind/share/classes/com/sun/xml/internal/rngom/binary/package.html 2015-09-19 13:16:36.449096802 +0300
@@ -45,6 +45,6 @@
-->
- Minimal binarized pattern object model (one example of ast.om implementation).
+ Minimal binarized pattern object model (one example of ast.om implementation).
--- old/src/jdk.xml.bind/share/classes/com/sun/xml/internal/rngom/nc/package.html 2015-09-19 13:16:37.093099996 +0300
+++ new/src/jdk.xml.bind/share/classes/com/sun/xml/internal/rngom/nc/package.html 2015-09-19 13:16:36.941099242 +0300
@@ -45,6 +45,6 @@
-->
- Default Name Class Object Model (one example of ast.om implementation).
+ Default Name Class Object Model (one example of ast.om implementation).
--- old/src/jdk.xml.bind/share/classes/com/sun/xml/internal/rngom/parse/host/package.html 2015-09-19 13:16:37.601102515 +0300
+++ new/src/jdk.xml.bind/share/classes/com/sun/xml/internal/rngom/parse/host/package.html 2015-09-19 13:16:37.453101781 +0300
@@ -43,5 +43,5 @@
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.
-->
-Implementation of the asm.builder package that uses two
+Implementation of the asm.builder package that uses two
other builds simultaneously.
--- old/src/jdk.xml.bind/share/classes/com/sun/xml/internal/xsom/XSAnnotation.java 2015-09-19 13:16:38.093104954 +0300
+++ new/src/jdk.xml.bind/share/classes/com/sun/xml/internal/xsom/XSAnnotation.java 2015-09-19 13:16:37.953104260 +0300
@@ -52,7 +52,7 @@
* @param o
* can be null.
* @return
- * old value that was replaced by the o .
+ * old value that was replaced by the {@code o}.
*/
Object setAnnotation(Object o);
--- old/src/jdk.xml.bind/share/classes/com/sun/xml/internal/xsom/XSComponent.java 2015-09-19 13:16:38.581107374 +0300
+++ new/src/jdk.xml.bind/share/classes/com/sun/xml/internal/xsom/XSComponent.java 2015-09-19 13:16:38.445106700 +0300
@@ -54,7 +54,7 @@
* false to make this method behavel like {@link #getAnnotation()}.
*
* @return
- * null if createIfNotExist==false and annotation didn't exist.
+ * null if {@code createIfNotExist==false} and annotation didn't exist.
* Otherwise non-null.
*/
XSAnnotation getAnnotation(boolean createIfNotExist);
--- old/src/jdk.xml.bind/share/classes/com/sun/xml/internal/xsom/XSElementDecl.java 2015-09-19 13:16:39.073109814 +0300
+++ new/src/jdk.xml.bind/share/classes/com/sun/xml/internal/xsom/XSElementDecl.java 2015-09-19 13:16:38.933109120 +0300
@@ -132,7 +132,7 @@
* by the given declaration.
*
*
- * Just a short cut of getSubstitutables().contain(e);
+ * Just a short cut of {@code getSubstitutables().contain(e);}
*/
boolean canBeSubstitutedBy(XSElementDecl e);
--- old/src/jdk.xml.bind/share/classes/com/sun/xml/internal/xsom/XSType.java 2015-09-19 13:16:39.585112353 +0300
+++ new/src/jdk.xml.bind/share/classes/com/sun/xml/internal/xsom/XSType.java 2015-09-19 13:16:39.429111579 +0300
@@ -35,7 +35,7 @@
/**
* Returns the base type of this type.
*
- * Note that if this type represents xs:anyType , this method returns itself.
+ * Note that if this type represents {@code xs:anyType}, this method returns itself.
* This is awkward as an API, but it follows the schema specification.
*
* @return always non-null.
@@ -48,9 +48,9 @@
int getDerivationMethod();
- /** Returns true if this instanceof XSSimpleType. */
+ /** Returns true if {@code this instanceof XSSimpleType}. */
boolean isSimpleType();
- /** Returns true if this instanceof XSComplexType. */
+ /** Returns true if {@code this instanceof XSComplexType}. */
boolean isComplexType();
/**
@@ -90,7 +90,7 @@
* Returns true if this type is derived from the specified type.
*
*
- * Note that t.isDerivedFrom(t) returns true.
+ * Note that {@code t.isDerivedFrom(t)} returns true.
*/
boolean isDerivedFrom( XSType t );
}
--- old/src/jdk.xml.bind/share/classes/com/sun/xml/internal/xsom/impl/parser/state/NGCCInterleaveFilter.java 2015-09-19 13:16:40.081114812 +0300
+++ new/src/jdk.xml.bind/share/classes/com/sun/xml/internal/xsom/impl/parser/state/NGCCInterleaveFilter.java 2015-09-19 13:16:39.933114078 +0300
@@ -71,14 +71,14 @@
//
/**
* Receiver that is being locked and therefore receives all the events.
- *
<![CDATA[
+ * <pre>{@code
* <interleave>
* <element name="foo"/>
* <element name="bar">
* <element name="foo"/>
* </element>
* </interlaeve>
- * ]]> <![CDATA[
+ * <pre>{@code
* <element name="foo">
* <choice>
* <element name="bar"><empty/></element>
* <text/>
* </choice>
* </element>
- * ]]>
+ * }
*
* Assume we hit the following instance:
- * <![CDATA[
+ * <pre>{@code
* <foo> <bar/></foo>
- * ]]>
+ * }
*
* Then this first space needs to be ignored (for otherwise, we will
* end up treating this space as the match to <text/> and won't
* be able to process <bar>.)
*
* Now assume the following instance:
- * <![CDATA[
+ * <pre>{@code
* <foo/>
- * ]]>
+ * }
*
* This time, we need to treat this empty string as a text, for
* otherwise we won't be able to accept this instance.
@@ -481,16 +481,16 @@
* the top of the effective bindings. Because of the
* timing difference between the startPrefixMapping method
* and the execution of the corresponding actions,
- * this value can be different from namespaces.size().
+ * this value can be different from {@code namespaces.size()}.
*
* For example, consider the following schema:
- *
<![CDATA[
+ * <pre>{@code
* <oneOrMore>
* <element name="foo"><empty/></element>
* </oneOrMore>
* code fragment X
* <element name="bob"/>
- * ]]>
- * Unlike schema components defined in XS**** interfaces,
+ * Unlike schema components defined in {@code XS****} interfaces,
* which are inherently de-coupled from where it was loaded from,
* {@link SchemaDocument} represents a single XML infoset that
* is a schema document.
@@ -58,7 +58,7 @@
* The namespace that this schema defines.
*
*
- * More precisely, this method simply returns the targetNamespace attribute
+ * More precisely, this method simply returns the {@code targetNamespace} attribute
* of the schema document. When schemas are referenced in certain ways
* (AKA chameleon schema), schema components in this schema document
* may end up defining components in other namespaces.
--- old/src/jdk.xml.bind/share/classes/org/relaxng/datatype/helpers/ParameterlessDatatypeBuilder.java 2015-09-19 13:16:41.597122330 +0300
+++ new/src/jdk.xml.bind/share/classes/org/relaxng/datatype/helpers/ParameterlessDatatypeBuilder.java 2015-09-19 13:16:41.453121616 +0300
@@ -43,7 +43,7 @@
*
*
* Typical usage would be:
- *
<![CDATA[
+ * <PRE>{@code
* class MyDatatypeLibrary implements DatatypeLibrary {
* ....
* DatatypeBuilder createDatatypeBuilder( String typeName ) {
@@ -51,7 +51,7 @@
* }
* ....
* }
- * ]]> Kohsuke KAWAGUCHI
*/
--- old/src/jdk.xml.bind/share/classes/org/relaxng/datatype/helpers/StreamingValidatorImpl.java 2015-09-19 13:16:42.085124750 +0300
+++ new/src/jdk.xml.bind/share/classes/org/relaxng/datatype/helpers/StreamingValidatorImpl.java 2015-09-19 13:16:41.949124075 +0300
@@ -45,7 +45,7 @@
*
*
* Typical usage would be:
- *
<![CDATA[
+ * <PRE>{@code
* class MyDatatype implements Datatype {
* ....
* public DatatypeStreamingValidator createStreamingValidator( ValidationContext context ) {
@@ -53,7 +53,7 @@
* }
* ....
* }
- * ]]> Kohsuke KAWAGUCHI
*/
--- old/src/jdk.xml.ws/share/classes/com/sun/tools/internal/ws/api/WsgenExtension.java 2015-09-19 13:16:42.585127229 +0300
+++ new/src/jdk.xml.ws/share/classes/com/sun/tools/internal/ws/api/WsgenExtension.java 2015-09-19 13:16:42.441126515 +0300
@@ -30,7 +30,7 @@
* The extension implementations are found using service
* discovery mechanism i.e. JAX-WS tooltime locates
* {@link WsgenExtension}s through the
- * META-INF/services/com.sun.tools.internal.ws.api.WsgenExtension
+ * {@code META-INF/services/com.sun.tools.internal.ws.api.WsgenExtension}
* files.
*
* {@link WsgenProtocol} annotation can be specified on the