com.jcabi.xml

Class XSLDocument

java.lang.Object

com.jcabi.xml.XSLDocument

All Implemented Interfaces:

XSL

@Immutable
@Loggable(value=1)
public final class XSLDocument
extends Object
implements XSL

Implementation of XSL.

Objects of this class are immutable and thread-safe.

Since:

0.4

Version:

$Id$

Author:

Yegor Bugayenko (yegor@tpc2.com)

Constructor Summary

Constructors

Constructor and Description
XSLDocument(InputStream stream) Public ctor, from XSL as an input stream.
XSLDocument(String src) Public ctor, from XSL as a string.
XSLDocument(URL url) Public ctor, from URL.
XSLDocument(XML src) Public ctor, from XML as a source.

Method Summary

Methods

Modifier and Type	Method and Description
static XSL	make(InputStream stream) Make an instance of XSL stylesheet without I/O exceptions.
static XSL	make(URL url) Make an instance of XSL stylesheet without I/O exceptions.
String	toString()
XML	transform(XML xml) Transform XML to another one.

Methods inherited from class java.lang.Object

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

Constructor Detail

XSLDocument

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

Public ctor, from XML as a source.

Parameters:

src - XSL document body

XSLDocument

public XSLDocument(@NotNull(message="XSL can\'t be NULL")
           String src)

Public ctor, from XSL as a string.

Parameters:

src - XML document body

XSLDocument

public XSLDocument(@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

XSLDocument

public XSLDocument(@NotNull(message="XSL input stream can\'t be NULL")
           InputStream stream)
            throws IOException

Public ctor, from XSL as an input stream.

Parameters:

stream - XSL input stream

Throws:

IOException - If fails to read

Method Detail

make

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

Make an instance of XSL stylesheet without I/O exceptions.

This factory method is useful when you need to create an instance of XSL stylesheet 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 XSL STYLESHEET = XSLDocument.make(
     Foo.class.getResourceAsStream("my-stylesheet.xsl")
   );
 }

Parameters:

stream - Input stream

Returns:

XSL stylesheet

make

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

Make an instance of XSL stylesheet without I/O exceptions.

Parameters:

url - URL with content

Returns:

XSL stylesheet

Since:

0.7.4

See Also:

make(InputStream)

toString

public String toString()

Overrides:

toString in class Object

transform

@NotNull(message="XML is never NULL")
public XML transform(@NotNull(message="XML can\'t be NULL")
                           XML xml)

Description copied from interface: XSL

Transform XML to another one.

Specified by:

transform in interface XSL

Parameters:

xml - Source XML document

Returns:

Result document