public String\[\] getIdentifiers()

throws SQLException, AuthorizeException;

//

// Add a binding to an external identifier

// Versions to accept separate namespace and identifier, or namespaced identifier.

public void addIdentifier(String nsIdentifier)

throws SQLException, AuthorizeException;

public void addIdentifier(String namespace, String identifier)

throws SQLException, AuthorizeException;

//

// remove a binding to an external identifier.

public void deleteIdentifier(String nsIdentifier)

public void deleteIdentifier(String namespace, String identifier)

throws SQLException, AuthorizeException

//

// Find BSF bound to an external identifier, returns null if none found.

// Versions to accept separate namespace and identifier, or namespaced identifier.

public BitstreamFormat findByIdentifier(Context context, String nsIdentifier)

throws SQLException, AuthorizeException, FormatRegistryException

public BitstreamFormat findByIdentifier(Context context, String namespace, String identifier)

throws SQLException, AuthorizeException, FormatRegistryException

//

// Advanced version with extra "import" param, says to NOT look

// for format in registries, but to return 'null' if there is no

// existing BSF matching the indicated format. (Mainly for internal use.)

public BitstreamFormat findByIdentifier(Context context, String namespace, String identifier, boolean import)

throws SQLException, AuthorizeException, FormatRegistryException

//

// Return true if this BSF conforms to the target identifier, i.e. if

// would be acceptable to a service that accepts the given format.

public boolean conformsTo(String nsIdentifier);

throws SQLException, AuthorizeException, FormatRegistryException

//

// Return/set the canonical filename extension (without ".").

public String getCanonicalExtension();

public setCanonicalExtension(String extension);

//

// Get and set the Name (takes place of ShortDescription)

public String  getName();

public void    setName(String s);

//

// Flags that show whether to override the values picked up from external registry

// Set to false to remove override.

public boolean isOverrideName();

public void setOverrideName(boolean val);

public boolean isOverrideDescription();

public void setOverrideDescription(boolean val);

public boolean isOverrideMIMEType();

public void setOverrideMIMEType(boolean val);

public boolean isOverrideCanonicalExtension();

public void setOverrideCanonicalExtension(boolean val);

//

// return true if this BSF is the unknown format.

public boolean isUnknown()

//

// return date this external-id was last imported to the BSF.

public Date getLastImported(String namespace, String id)

public Date getLastImported(String nsidentifier)

throws SQLException, AuthorizeException

//

// set the date this external-id was last imported to the BSF.

public void setLastImported(String namespace, String id, Date newdate)

public void setLastImported(String nsidentifier, Date newdate)

throws SQLException, AuthorizeException

void   delete();

static BitstreamFormat   find(Context context, int id);

static BitstreamFormat   findUnknown(Context context);

static BitstreamFormat\[\] findAll(Context context);

String  getDescription();

int     getID()

String  getMIMEType();

int     getSupportLevel();

static int  getSupportLevelID(String slevel);

void    setDescription(String s);

void    setMIMEType(String s);

void    setSupportLevel(int sl);

void    update();

\{

// Namespaces for internal format registry - contains only "Unknown"

public static final String INTERNAL_NAMESPACE = "Internal";

//

// Name of the unknown format:

public static final String UNKNOWN_FORMAT_IDENTIFIER = "Unknown";

//

// Applications should use this as default mime-type.

public static final String DEFAULT_MIME_TYPE = "application/octet-stream";

//

// returns possibly-localized human-readable name of Unknown format.

public static String getUnknownFormatName(Context context);

//

// Returns registry plugin for external format identifier namespace

public static FormatRegistry find(String namespace);

//

// Returns array of *all* Namespace strings, even "artifacts" no longer configured.

public static String\[\] getAllNamespaces(Context context)

throws SQLException, AuthorizeException

//

// Returns array of all currently Namespaces of external registries.

public static String\[\] getRegistryNamespaces();

//

// Calls apropriate registry plugin to import format bound to a namespaced identifier.

// Returns null on error.

public static BitstreamFormat importExternalFormat(Context context, String namespace, String identifier)

throws FormatRegistryException, AuthorizeException

//

// Calls apropriate registry plugin to update format bound to a namespaced identifier.

// When force is true, update even when external format has not been modified.

public static void updateBitstreamFormat(Context context, BitstreamFormat existing, String namespace, String identifier, boolean force)

throws FormatRegistryException, AuthorizeException

//

// Calls apropriate registry plugin to compare two namespaced

// identifies (which must be in the same namespace).

public static boolean conformsTo(String nsIdent1, String nsIdent2)

throws FormatRegistryException

//

// Creates a namespaced identifier out of separate namespace and registry-specific identifier.

public static String makeIdentifier(String namespace, String identifier);

//

// Returns the namespace or identifier portion of a namespaced identifier.

public static String namespaceOf(String nsIdentifier)

public static String identifierOf(String nsIdentifier)

\}

package org.dspace.content.format;

public interface FormatRegistry

\{

// Typically returns 1 element, the Namespace name of the implementation's registry

String \[\] getPluginNames();

//

// Returns the DSpace namespace of this registry.

public String getNamespace();

//

// Return an URL needed to configure the underlying registry service;

// this allows the registry to configure itself from the DSpace

// configuration.

public URL getContactURL();

//

// Returns all external identifiers known to be synoyms of the

// given one, in namespaced-identifier format. (Because one registry

// may know about synonyms in other registries.)

public String\[\] getSynonymIdentifiers(Context context, String identifier)

throws FormatRegistryException, AuthorizeException

//

// Import a new data format - returns a BitstreamFormat.  There

// not be any existing BSF with the same namespace and identifier.

public BitstreamFormat importExternalFormat(Context context, String identifier)

throws FormatRegistryException, AuthorizeException

//

// Compare existing DSpace format against registry, updating anything that's changed.

// NOTE: it does not need to check last-modified date, framework does that.

public BitstreamFormat updateBitstreamFormat(Context context, BitstreamFormat existing, String identifier)

throws FormatRegistryException, AuthorizeException

//

// Return date when this entry was last changed, or null if unknown.

public Date getLastModified(String identifier)

throws FormatRegistryException

//

// Predicate, true if format named by sub is a subtype or

// otherwise "conforms" to the format defined by fmt.

public boolean conformsTo(String sub, String fmt)

throws FormatRegistryException

//

// Free any resources associated with this registry connection,

// since it will not be used any more.

public void shutdown()

\}