File	Doc	Category	Size	Date	Package
XMLDecoder.java	API Doc	Java SE 6 API	7784	Tue Jun 10 00:25:32 BST 2008	java.beans

XMLDecoder

• java.lang.Object

XMLDecoder d = new XMLDecoder(
new BufferedInputStream(
new FileInputStream("Test.xml")));
Object result = d.readObject();
d.close();

Fields Summary
private InputStream	in
private Object	owner
private ExceptionListener	exceptionListener
private com.sun.beans.ObjectHandler	handler
private Reference	clref

Constructors Summary
public XMLDecoder(InputStream in) Creates a new input stream for reading archives created by the XMLEncoder class. param in The underlying stream. see XMLEncoder#XMLEncoder(java.io.OutputStream) this(in, null);
public XMLDecoder(InputStream in, Object owner) Creates a new input stream for reading archives created by the XMLEncoder class. param in The underlying stream. param owner The owner of this stream. this(in, owner, null);
public XMLDecoder(InputStream in, Object owner, ExceptionListener exceptionListener) Creates a new input stream for reading archives created by the XMLEncoder class. param in the underlying stream. param owner the owner of this stream. param exceptionListener the exception handler for the stream; if null the default exception listener will be used. this(in, owner, exceptionListener, null);
public XMLDecoder(InputStream in, Object owner, ExceptionListener exceptionListener, ClassLoader cl) Creates a new input stream for reading archives created by the XMLEncoder class. param in the underlying stream. null may be passed without error, though the resulting XMLDecoder will be useless param owner the owner of this stream. null is a legal value param exceptionListener the exception handler for the stream, or null to use the default param cl the class loader used for instantiating objects. null indicates that the default class loader should be used since 1.5 this.in = in; setOwner(owner); setExceptionListener(exceptionListener); setClassLoader(cl);

Methods Summary
public void	close() This method closes the input stream associated with this stream. if (in != null) { getHandler(); try { in.close(); } catch (IOException e) { getExceptionListener().exceptionThrown(e); } }
private java.lang.ClassLoader	getClassLoader() Return the class loader used to instantiate objects. If the class loader has not been explicitly set then null is returned. return the class loader used to instantiate objects if (clref != null) { return (ClassLoader)clref.get(); } return null;
public java.beans.ExceptionListener	getExceptionListener() Gets the exception handler for this stream. return The exception handler for this stream. Will return the default exception listener if this has not explicitly been set. see #setExceptionListener return (exceptionListener != null) ? exceptionListener : Statement.defaultExceptionListener;
private com.sun.beans.ObjectHandler	getHandler() Returns the object handler for input stream. The object handler is created if necessary. return the object handler if ( handler == null ) { SAXParserFactory factory = SAXParserFactory.newInstance(); try { SAXParser parser = factory.newSAXParser(); handler = new ObjectHandler( this, getClassLoader() ); parser.parse( in, handler ); } catch ( ParserConfigurationException e ) { getExceptionListener().exceptionThrown( e ); } catch ( SAXException se ) { Exception e = se.getException(); if ( e == null ) { e = se; } getExceptionListener().exceptionThrown( e ); } catch ( IOException ioe ) { getExceptionListener().exceptionThrown( ioe ); } } return handler;
public java.lang.Object	getOwner() Gets the owner of this decoder. return The owner of this decoder. see #setOwner return owner;
public java.lang.Object	readObject() Reads the next object from the underlying input stream. return the next object read throws ArrayIndexOutOfBoundsException if the stream contains no objects (or no more objects) see XMLEncoder#writeObject if (in == null) { return null; } return getHandler().dequeueResult();
private void	setClassLoader(java.lang.ClassLoader cl) Set the class loader used to instantiate objects for this stream. param cl a classloader to use; if null then the default class loader will be used if (cl != null) { this.clref = new WeakReference(cl); }
public void	setExceptionListener(java.beans.ExceptionListener exceptionListener) Sets the exception handler for this stream to exceptionListener. The exception handler is notified when this stream catches recoverable exceptions. param exceptionListener The exception handler for this stream; if null the default exception listener will be used. see #getExceptionListener this.exceptionListener = exceptionListener;
public void	setOwner(java.lang.Object owner) Sets the owner of this decoder to owner. param owner The owner of this decoder. see #getOwner this.owner = owner;