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


Copyright © 2007-2010 The Planets Consortium. All Rights Reserved.