/*
* @(#)DOMFactory.java
*
* Copyright (c) 1996-2010 by the original authors of JHotDraw and all its
* contributors. All rights reserved.
*
* You may not use, copy or modify this file, except in compliance with the
* license agreement you entered into with the copyright holders. For details
* see accompanying license terms.
*/
package org.jhotdraw.xml;
import java.io.IOException;
/**
* DOMFactory.
*
*
* Design Patterns
*
* Abstract Factory
* {@code DOMFactory} is used by {@code DOMInput} and {@code DOMOutput} for
* creating Java objects and DOM elements.
* Abstract Factory: {@link DOMFactory}
* Client: {@link DOMInput}, {@link DOMOutput}.
*
*
Strategy
* {@code DOMFactory} is used by {@code DOMInput} and {@code DOMOutput} for
* reading and writing objects.
* Client: {@link DOMInput}, {@link DOMOutput}.
* Strategy: {@link DOMFactory}.
*
*
Chain of Responsibility
* {@code DOMFactory} can delegate reading and writing to objects which implement
* the {@code DOMStorable} interface.
* Client: {@link DOMFactory}.
* Handler: {@link DOMStorable}.
*
*
* @author Werner Randelshofer
* @version $Id: DOMFactory.java 719 2010-11-22 16:53:51Z rawcoder $
*/
public interface DOMFactory {
/**
* Returns the element name for the specified object.
*/
public String getName(Object o);
/**
* Creates an object from the specified element name.
*/
public Object create(String name);
/** Writes the specified object to DOMOutput.
*
* This method is only ever called from DOMOutput. You should never call
* this method directly.
*
* @param object The object to be written.
*/
public void write(DOMOutput out, Object object) throws IOException;
/** Reads the specified object from {@code DOMInput}.
*
* This method is only ever called from {@code DOMInput}. You should never call
* this method directly.
*
* If the object returned by this method is an instanceof {@link DOMStorable}
* then {@code DOMInput} invokes its read method.
*
* @param in The {@code DOMInput} object which creates the object from an element
* in a DOM.
*/
public Object read(DOMInput in) throws IOException;
}
Ads help maintain this website.