com.jcabi.xml

Class XSDDocument

java.lang.Object

com.jcabi.xml.XSDDocument

All Implemented Interfaces:

XSD

@Immutable
public final class XSDDocument
extends Object
implements XSD

Implementation of XSD.

Objects of this class are immutable and thread-safe.

Since:

0.5

Version:

$Id$

Author:

Yegor Bugayenko (yegor@tpc2.com)

Constructor Summary

Constructors

Constructor and Description
XSDDocument(InputStream stream) Public ctor, from XSD as an input stream.
XSDDocument(String src) Public ctor, from XSD as a string.
XSDDocument(URI uri) Public ctor, from URI.
XSDDocument(URL url) Public ctor, from URL.
XSDDocument(XML src) Public ctor, from XSD as a source.

Method Summary

Methods

Modifier and Type	Method and Description
static XSD	make(InputStream stream) Make an instance of XSD schema without I/O exceptions.
static XSD	make(URL url) Make an instance of XSD schema without I/O exceptions.
String	toString()
Collection<SAXParseException>	validate(Source xml) Validate XML.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

XSDDocument

public XSDDocument(@NotNull(message="XML can\'t be NULL")
           XML src)

Public ctor, from XSD as a source.

Parameters:

src - XSD document body

XSDDocument

public XSDDocument(@NotNull(message="XSD text can\'t be NULL")
           String src)

Public ctor, from XSD as a string.

Parameters:

src - XSD document body

XSDDocument

public XSDDocument(@NotNull(message="URL can\'t be NULL")
           URL url)
            throws IOException

Public ctor, from URL.

Parameters:

url - Location of document

Throws:

IOException - If fails to read

Since:

0.7.4

XSDDocument

public XSDDocument(@NotNull(message="URI can\'t be NULL")
           URI uri)
            throws IOException

Public ctor, from URI.

Parameters:

uri - Location of document

Throws:

IOException - If fails to read

Since:

0.15

XSDDocument

public XSDDocument(@NotNull(message="XSD input stream can\'t be NULL")
           InputStream stream)

Public ctor, from XSD as an input stream.

Parameters:

stream - XSD input stream

Method Detail

make

public static XSD make(@NotNull(message="XSD input stream can\'t be NULL")
       InputStream stream)

Make an instance of XSD schema without I/O exceptions.

This factory method is useful when you need to create an instance of XSD schema as a static final variable. In this case you can't catch an exception but this method can help, for example:

 class Foo {
   private static final XSD SCHEMA = XSDDocument.make(
     Foo.class.getResourceAsStream("my-schema.xsd")
   );
 }

Parameters:

stream - Input stream

Returns:

XSD schema

make

public static XSD make(@NotNull(message="URL can\'t be NULL")
       URL url)

Make an instance of XSD schema without I/O exceptions.

Parameters:

url - URL with content

Returns:

XSD schema

Since:

0.7.4

See Also:

make(InputStream)

toString

public String toString()

Overrides:

toString in class Object

validate

@NotNull(message="list of exceptions is never NULL")
public Collection<SAXParseException> validate(@NotNull(message="XML can\'t be NULL")
                                                    Source xml)

Description copied from interface: XSD

Validate XML.

Specified by:

validate in interface XSD

Parameters:

xml - Source XML document

Returns:

Collection of problems found (empty if no problems)