Differences between revisions 1 and 9 (spanning 8 versions)
Revision 1 as of 2008-10-16 15:02:04
Size: 4175
Editor: abr
Comment:
Revision 9 as of 2008-10-16 16:09:53
Size: 4110
Editor: abr
Comment:
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
=== API-A (Fedora Access service API) === = API-A (Fedora Access service API) =
Line 3: Line 3:
[[Anchor(anchor_describeRepository)]]
==== describeRepository ====
[[Anchor(describeRepository)]]
== describeRepository ==
Line 8: Line 8:
 * {{{RepositoryInfo}}} A data structure that contains key metadata describing the Fedora repository server including repository name, version, base URL, pid namespace, and sample request URLs. (See definition of [#anchor_RepositoryInfo RepositoryInfo] under Data structures below)  * [:/../DataStructures#RepositoryInfo: RepositoryInfo]
Line 14: Line 14:
[[Anchor(anchor_getDatastreamDissemination)]]
==== getDatastreamDissemination ====
Gets the content of a datastream.

[[Anchor(getObjectProfile)]]
== getObjectProfile ==
Gets the !ObjectProfile of an object, which includes key metadata fields and URLs for the object Dissemination Index and the object Item Index. Can be thought of as a default view of the object.
Line 19: Line 20:
 * {{{String pid}}} The PID of the object.
 * {{{String dsID}}} The datastream ID.
 * {{{String asOfDateTime}}} A dateTime indicating the version of the datastream to retrieve. If null, Fedora will use the most recent version.
 * {{{String pid}}} The pid of the object.
 * {{{String asOfDateTime}}} The date/time stamp specifying the desired version of the object. If null, the current version of the object (the most recent time) is assumed.
Line 24: Line 24:
 * {{{MIMETypedStream}}} The datastream as a mime-typed stream. (See definition of [#anchor_MIMETypedStream MIMETypedStream] under Data structures below)  * {{{ObjectProfile}}} Contains these fields
  * {{{String pid}}}
  * {{{String objLabel}}}
  * {{{String[] objModels}}}
  * {{{String objCreateDate}}}
  * {{{String objLastModDate}}}
  * {{{String objDissIndexViewURL}}}
  * {{{String objItemIndexViewURL}}}
Line 30: Line 37:
[[Anchor(anchor_getDissemination)]]
==== getDissemination ====
Disseminates the content produced by executing the method specified in the service definition associated the specified digital object.

Input parameters:
 * {{{String pid}}} The pid of the object.
 * {{{String serviceDefinitionPid}}} The PID of the Service Definition object.
 * {{{String methodName}}} The name of the method to be executed.
 * {{{Property[] parameters}}} An array of name-value pairs.
 * {{{String asOfDateTime}}} The versioning dateTime. If null, Fedora will use the most recent version.

Returns:
 * {{{MIMETypedStream}}} A MIME-typed stream containing the result of the dissemination. (See definition of [#anchor_MIMETypedStream MIMETypedStream] under Data structures below)

Throws:
 * {{{java.rmi.RemoteException}}}
Line 48: Line 39:
[[Anchor(anchor_getObjectHistory)]]
==== getObjectHistory ====
[[Anchor(getObjectHistory)]]
== getObjectHistory ==
Line 62: Line 53:
[[Anchor(anchor_getObjectProfile)]]
==== getObjectProfile ====
Gets the !ObjectProfile of an object, which includes key metadata fields and URLs for the object Dissemination Index and the object Item Index. Can be thought of as a default view of the object.


[[Anchor(listDatastreams)]]
== listDatastreams ==
Lists the datastreams of an object. See also [#getDatastreamDissemination getDatastreamDissemination]
Line 71: Line 64:
 * {{{ObjectProfile}}} The !ObjectProfile of the object. (See definition of [#anchor_ObjectProfile ObjectProfile] under Data structures below)  * A sequence/array of:
  * {{{DatastreamDef}}}
   * {{{String ID}}}
   * {{{String label}}}
   * {{{String MIMEType}}}

Line 77: Line 76:
[[Anchor(anchor_listDatastreams)]]
==== listDatastreams ====
Lists the datastreams of an object.
[[Anchor(getDatastreamDissemination)]]
== getDatastreamDissemination ==

Gets the content of a datastream. See also [#listDatastreams listDatastreams]

Input parameters:
 * {{{String pid}}} The PID of the object.
 * {{{String dsID}}} The datastream ID.
 * {{{String asOfDateTime}}} A dateTime indicating the version of the datastream to retrieve. If null, Fedora will use the most recent version.

Returns:
 * [:/../DataStructures#MIMETypedStream: MIMETypedStream] The header will be empty, or if applicable, contain the http header as name/value pairs.

Throws:
 * {{{java.rmi.RemoteException}}}




[[Anchor(listMethods)]]
== listMethods ==
Lists all the methods that the object supports. See also [#getDissemination getDissemination]
Line 86: Line 104:
 * {{{DatastreamDef[]}}} A sequence of !DatastreamDefs. (See definition of [#anchor_DatastreamDef DatastreamDef] under Data structures below)  * A sequence/array of [:/../DataStructures#MethodDef: MethodDef]s, one for each of the disseminators on the object
Line 92: Line 110:
[[Anchor(anchor_listMethods)]]
==== listMethods ====
Lists all the methods that the object supports.
[[Anchor(getDissemination)]]
== getDissemination ==
Disseminates the content produced by executing the method specified in the service definition associated the specified digital object. See also [#listMethods listMethods]
Line 98: Line 116:
 * {{{String asOfDateTime}}} The date/time stamp specifying the desired version of the object. If null, the current version of the object (the most recent time) is assumed.  * {{{String serviceDefinitionPid}}} The PID of the Service Definition object.
 * {{{String methodName}}} The name of the method to be executed.
 * {{{Property[] parameters}}} An array of name-value pairs.
 * {{{String asOfDateTime}}} The versioning dateTime. If null, Fedora will use the most recent version.
Line 101: Line 122:
 * {{{ObjectMethodsDef[]}}} A sequence of !ObjectMethodsDefs. (See definition of [#anchor_ObjectMethodsDef ObjectMethodsDef] under Data structures below)  * [:/../DataStructures#MIMETypedStream: MIMETypedStream] The header will be empty, or if applicable, contain the http header as name/value pairs.
Line 105: Line 126:

API-A (Fedora Access service API)

Anchor(describeRepository)

describeRepository

Gets information that describes the repository.

Returns:

Throws:

  • java.rmi.RemoteException

Anchor(getObjectProfile)

getObjectProfile

Gets the ObjectProfile of an object, which includes key metadata fields and URLs for the object Dissemination Index and the object Item Index. Can be thought of as a default view of the object.

Input parameters:

  • String pid The pid of the object.

  • String asOfDateTime The date/time stamp specifying the desired version of the object. If null, the current version of the object (the most recent time) is assumed.

Returns:

  • ObjectProfile Contains these fields

    • String pid

    • String objLabel

    • String[] objModels

    • String objCreateDate

    • String objLastModDate

    • String objDissIndexViewURL

    • String objItemIndexViewURL

Throws:

  • java.rmi.RemoteException

Anchor(getObjectHistory)

getObjectHistory

Gets a list of timestamps that correspond to modification dates of components. This currently includes changes to Datastreams and disseminators.

Input parameters:

  • String pid The pid of the object.

Returns:

  • String[] An array containing the list of timestamps indicating when changes were made to the object.

Throws:

  • java.rmi.RemoteException

Anchor(listDatastreams)

listDatastreams

Lists the datastreams of an object. See also [#getDatastreamDissemination getDatastreamDissemination]

Input parameters:

  • String pid The pid of the object.

  • String asOfDateTime The date/time stamp specifying the desired version of the object. If null, the current version of the object (the most recent time) is assumed.

Returns:

  • A sequence/array of:
    • DatastreamDef

      • String ID

      • String label

      • String MIMEType

Throws:

  • java.rmi.RemoteException

Anchor(getDatastreamDissemination)

getDatastreamDissemination

Gets the content of a datastream. See also [#listDatastreams listDatastreams]

Input parameters:

  • String pid The PID of the object.

  • String dsID The datastream ID.

  • String asOfDateTime A dateTime indicating the version of the datastream to retrieve. If null, Fedora will use the most recent version.

Returns:

Throws:

  • java.rmi.RemoteException

Anchor(listMethods)

listMethods

Lists all the methods that the object supports. See also [#getDissemination getDissemination]

Input parameters:

  • String pid The pid of the object.

  • String asOfDateTime The date/time stamp specifying the desired version of the object. If null, the current version of the object (the most recent time) is assumed.

Returns:

Throws:

  • java.rmi.RemoteException

Anchor(getDissemination)

getDissemination

Disseminates the content produced by executing the method specified in the service definition associated the specified digital object. See also [#listMethods listMethods]

Input parameters:

  • String pid The pid of the object.

  • String serviceDefinitionPid The PID of the Service Definition object.

  • String methodName The name of the method to be executed.

  • Property[] parameters An array of name-value pairs.

  • String asOfDateTime The versioning dateTime. If null, Fedora will use the most recent version.

Returns:

Throws:

  • java.rmi.RemoteException

Fedora 3.0 API/Access (last edited 2010-03-17 13:08:52 by localhost)