MessageFactory.java

package rescuecore2.registry;

import rescuecore2.messages.Message;

import java.io.InputStream;
import java.io.IOException;

/**
   Factory class for creating messages.
 */
public interface MessageFactory {
    /**
       Create a message based on its urn and populate it with data from a stream. If the urn is not recognised then return null.
       @param urn The urn of the message type to create.
       @param data An InputStream to read message data from.
       @return A new Message object, or null if the urn is not recognised.
       @throws IOException If there is a problem reading the stream.
     */
    Message makeMessage(String urn, InputStream data) throws IOException;

    /**
       Get all message urns understood by this factory.
       @return All message urns.
    */
    String[] getKnownMessageURNs();
}