eu.planets_project.services.migrate
Interface MigrateAsync

All Superinterfaces:

PlanetsService

@MTOM
@StreamingAttachment(parseEagerly=true,
                     memoryThreshold=10485760L)
public interface MigrateAsync
extends PlanetsService

This is intended to become the generic migration interface for complex migration services. ******************* NOT IN SERVICE AT PRESENT ************************** It should: - Support service description to facilitate discovery. - Allow multiple input formats and output formats to be dealt with be the same service. - Allow parameters to be discovered and submitted to control the migration. - Allow digital objects composed of more than one file/bitstream. - Allow Files/bitstreams passed by value OR by reference. - Provide methods for asynchronous invocation.

Nested Class Summary

static class

MigrateAsync.AsyncStatus Enum to track the asynch process status

Field Summary

static java.lang.String	NAME The interface name
static javax.xml.namespace.QName	QNAME The qualified name

Method Summary

MigrateResult	getMigrateAsyncResult(java.lang.String ticket)
MigrateAsync.AsyncStatus	pollStatus(java.lang.String ticket)
java.lang.String	startMigrate(DigitalObject digitalObject, java.net.URI inputFormat, java.net.URI outputFormat, java.net.URL writeLocation, java.util.List<Parameter> parameters)

Methods inherited from interface eu.planets_project.services.PlanetsService

describe

Field Detail

NAME

static final java.lang.String NAME

The interface name

See Also:

Constant Field Values

QNAME

static final javax.xml.namespace.QName QNAME

The qualified name

Method Detail

startMigrate

java.lang.String startMigrate(DigitalObject digitalObject,
                              java.net.URI inputFormat,
                              java.net.URI outputFormat,
                              java.net.URL writeLocation,
                              java.util.List<Parameter> parameters)

Parameters:

digitalObject - The digital object to migrate

inputFormat - Format URI for the digital object path (migrate from)

outputFormat - Format URI for the desired ouput (migrate to)

writeLocation - a location (URL) to write the result to

parameters - extra parameters to control particular tools

Returns:

A new digital object, the result of migrating the given digital object

pollStatus

MigrateAsync.AsyncStatus pollStatus(java.lang.String ticket)

Parameters:

ticket - The ticket

Returns:

the current status enum

getMigrateAsyncResult

MigrateResult getMigrateAsyncResult(java.lang.String ticket)

Parameters:

ticket - The ticket

Returns:

the completed job MigrateResult