/** * This is used to create an <code>InputNode</code> that can be * used to read XML from the specified stream. The stream will * be positioned at the root element in the XML document. * * @param source this contains the contents of the XML source * * @throws Exception thrown if there is an I/O exception */ public static InputNode read(InputStream source) throws Exception { return read(PROVIDER.provide(source)); }
/** * This is used to create an <code>InputNode</code> that can be * used to read XML from the specified reader. The reader will * be positioned at the root element in the XML document. * * @param source this contains the contents of the XML source * * @throws Exception thrown if there is an I/O exception */ public static InputNode read(Reader source) throws Exception { return read(PROVIDER.provide(source)); }
/** * This is used to create an <code>InputNode</code> that can be * used to read XML from the specified stream. The stream will * be positioned at the root element in the XML document. * * @param source this contains the contents of the XML source * * @throws Exception thrown if there is an I/O exception */ public static InputNode read(InputStream source) throws Exception { return read(PROVIDER.provide(source)); }
/** * This is used to create an <code>InputNode</code> that can be * used to read XML from the specified reader. The reader will * be positioned at the root element in the XML document. * * @param source this contains the contents of the XML source * * @throws Exception thrown if there is an I/O exception */ public static InputNode read(Reader source) throws Exception { return read(PROVIDER.provide(source)); }
/** * This is used to create an <code>InputNode</code> that can be * used to read XML from the specified stream. The stream will * be positioned at the root element in the XML document. * * @param source this contains the contents of the XML source * * @throws Exception thrown if there is an I/O exception */ public static InputNode read(InputStream source) throws Exception { return read(PROVIDER.provide(source)); }
/** * This is used to create an <code>InputNode</code> that can be * used to read XML from the specified reader. The reader will * be positioned at the root element in the XML document. * * @param source this contains the contents of the XML source * * @throws Exception thrown if there is an I/O exception */ public static InputNode read(Reader source) throws Exception { return read(PROVIDER.provide(source)); }
/** * This <code>read</code> method will read the contents of the XML * document from the provided source and populate the object with * the values deserialized. This is used as a means of injecting an * object with values deserialized from an XML document. If the * XML source cannot be deserialized or there is a problem building * the object graph an exception is thrown. * * @param value this is the object to deserialize the XML in to * @param source this provides the source of the XML document * @param strict this determines whether to read in strict mode * * @return the same instance provided is returned when finished * * @throws Exception if the object cannot be fully deserialized */ public <T> T read(T value, InputStream source, boolean strict) throws Exception{ return read(value, NodeBuilder.read(source), strict); }
/** * This <code>read</code> method will read the contents of the XML * document from the provided source and convert it into an object * of the specified type. If the XML source cannot be deserialized * or there is a problem building the object graph an exception * is thrown. The instance deserialized is returned. * * @param type this is the class type to be deserialized from XML * @param source this provides the source of the XML document * @param strict this determines whether to read in strict mode * * @return the object deserialized from the XML document * * @throws Exception if the object cannot be fully deserialized */ public <T> T read(Class<? extends T> type, InputStream source, boolean strict) throws Exception { return read(type, NodeBuilder.read(source), strict); }
/** * This <code>read</code> method will read the contents of the XML * document from the provided source and populate the object with * the values deserialized. This is used as a means of injecting an * object with values deserialized from an XML document. If the * XML source cannot be deserialized or there is a problem building * the object graph an exception is thrown. * * @param value this is the object to deserialize the XML in to * @param source this provides the source of the XML document * @param strict this determines whether to read in strict mode * * @return the same instance provided is returned when finished * * @throws Exception if the object cannot be fully deserialized */ public <T> T read(T value, InputStream source, boolean strict) throws Exception{ return read(value, NodeBuilder.read(source), strict); }
/** * This <code>read</code> method will read the contents of the XML * document from the provided source and populate the object with * the values deserialized. This is used as a means of injecting an * object with values deserialized from an XML document. If the * XML source cannot be deserialized or there is a problem building * the object graph an exception is thrown. * * @param value this is the object to deserialize the XML in to * @param source this provides the source of the XML document * @param strict this determines whether to read in strict mode * * @return the same instance provided is returned when finished * * @throws Exception if the object cannot be fully deserialized */ public <T> T read(T value, Reader source, boolean strict) throws Exception{ return read(value, NodeBuilder.read(source), strict); }
/** * This <code>read</code> method will read the contents of the XML * document from the provided source and convert it into an object * of the specified type. If the XML source cannot be deserialized * or there is a problem building the object graph an exception * is thrown. The instance deserialized is returned. * * @param type this is the class type to be deserialized from XML * @param source this provides the source of the XML document * @param strict this determines whether to read in strict mode * * @return the object deserialized from the XML document * * @throws Exception if the object cannot be fully deserialized */ public <T> T read(Class<? extends T> type, Reader source, boolean strict) throws Exception { return read(type, NodeBuilder.read(source), strict); }
/** * This <code>read</code> method will read the contents of the XML * document from the provided source and convert it into an object * of the specified type. If the XML source cannot be deserialized * or there is a problem building the object graph an exception * is thrown. The instance deserialized is returned. * * @param type this is the class type to be deserialized from XML * @param source this provides the source of the XML document * @param strict this determines whether to read in strict mode * * @return the object deserialized from the XML document * * @throws Exception if the object cannot be fully deserialized */ public <T> T read(Class<? extends T> type, InputStream source, boolean strict) throws Exception { return read(type, NodeBuilder.read(source), strict); }
/** * This <code>read</code> method will read the contents of the XML * document from the provided source and populate the object with * the values deserialized. This is used as a means of injecting an * object with values deserialized from an XML document. If the * XML source cannot be deserialized or there is a problem building * the object graph an exception is thrown. * * @param value this is the object to deserialize the XML in to * @param source this provides the source of the XML document * @param strict this determines whether to read in strict mode * * @return the same instance provided is returned when finished * * @throws Exception if the object cannot be fully deserialized */ public <T> T read(T value, Reader source, boolean strict) throws Exception{ return read(value, NodeBuilder.read(source), strict); }
/** * This <code>read</code> method will read the contents of the XML * document from the provided source and convert it into an object * of the specified type. If the XML source cannot be deserialized * or there is a problem building the object graph an exception * is thrown. The instance deserialized is returned. * * @param type this is the class type to be deserialized from XML * @param source this provides the source of the XML document * @param strict this determines whether to read in strict mode * * @return the object deserialized from the XML document * * @throws Exception if the object cannot be fully deserialized */ public <T> T read(Class<? extends T> type, Reader source, boolean strict) throws Exception { return read(type, NodeBuilder.read(source), strict); }
/** * This <code>validate</code> method will validate the contents of * the XML document against the specified XML class schema. This is * used to perform a read traversal of the class schema such that * the document can be tested against it. This is preferred to * reading the document as it does not instantiate the objects or * invoke any callback methods, thus making it a safe validation. * * @param type this is the class type to be validated against XML * @param source this provides the source of the XML document * @param strict this determines whether to read in strict mode * * @return true if the document matches the class XML schema * * @throws Exception if the class XML schema does not fully match */ public boolean validate(Class type, Reader source, boolean strict) throws Exception { return validate(type, NodeBuilder.read(source), strict); }
/** * This <code>read</code> method will read the contents of the XML * document from the provided source and convert it into an object * of the specified type. If the XML source cannot be deserialized * or there is a problem building the object graph an exception * is thrown. The instance deserialized is returned. * * @param type this is the class type to be deserialized from XML * @param source this provides the source of the XML document * @param strict this determines whether to read in strict mode * * @return the object deserialized from the XML document * * @throws Exception if the object cannot be fully deserialized */ public <T> T read(Class<? extends T> type, Reader source, boolean strict) throws Exception { return read(type, NodeBuilder.read(source), strict); }
/** * This <code>validate</code> method will validate the contents of * the XML document against the specified XML class schema. This is * used to perform a read traversal of the class schema such that * the document can be tested against it. This is preferred to * reading the document as it does not instantiate the objects or * invoke any callback methods, thus making it a safe validation. * * @param type this is the class type to be validated against XML * @param source this provides the source of the XML document * @param strict this determines whether to read in strict mode * * @return true if the document matches the class XML schema * * @throws Exception if the class XML schema does not fully match */ public boolean validate(Class type, InputStream source, boolean strict) throws Exception { return validate(type, NodeBuilder.read(source), strict); }
/** * This <code>validate</code> method will validate the contents of * the XML document against the specified XML class schema. This is * used to perform a read traversal of the class schema such that * the document can be tested against it. This is preferred to * reading the document as it does not instantiate the objects or * invoke any callback methods, thus making it a safe validation. * * @param type this is the class type to be validated against XML * @param source this provides the source of the XML document * @param strict this determines whether to read in strict mode * * @return true if the document matches the class XML schema * * @throws Exception if the class XML schema does not fully match */ public boolean validate(Class type, Reader source, boolean strict) throws Exception { return validate(type, NodeBuilder.read(source), strict); }
/** * This <code>read</code> method will read the contents of the XML * document from the provided source and convert it into an object * of the specified type. If the XML source cannot be deserialized * or there is a problem building the object graph an exception * is thrown. The instance deserialized is returned. * * @param type this is the class type to be deserialized from XML * @param source this provides the source of the XML document * @param strict this determines whether to read in strict mode * * @return the object deserialized from the XML document * * @throws Exception if the object cannot be fully deserialized */ public <T> T read(Class<? extends T> type, InputStream source, boolean strict) throws Exception { return read(type, NodeBuilder.read(source), strict); }
/** * This <code>validate</code> method will validate the contents of * the XML document against the specified XML class schema. This is * used to perform a read traversal of the class schema such that * the document can be tested against it. This is preferred to * reading the document as it does not instantiate the objects or * invoke any callback methods, thus making it a safe validation. * * @param type this is the class type to be validated against XML * @param source this provides the source of the XML document * @param strict this determines whether to read in strict mode * * @return true if the document matches the class XML schema * * @throws Exception if the class XML schema does not fully match */ public boolean validate(Class type, InputStream source, boolean strict) throws Exception { return validate(type, NodeBuilder.read(source), strict); }