org.openprovenance.prov.interop

Class InteropFramework

java.lang.Object

org.openprovenance.prov.interop.InteropFramework

All Implemented Interfaces:

InteropMediaType

public class InteropFramework
extends Object
implements InteropMediaType

The interoperability framework for PROV, with utility methods to write and read documents to files and streams, according to media types, format (specified as InteropFramework.ProvFormat). The class also provides helper functions to support content negotiation.

Author:

lavm, dtm

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	InteropFramework.ProvFormat An enumerated type for all the PROV serializations supported by ProvToolbox.
static class	InteropFramework.ProvFormatType

Field Summary

Fields

Modifier and Type	Field and Description
Hashtable<InteropFramework.ProvFormat,String>	extensionMap
Hashtable<String,InteropFramework.ProvFormat>	extensionRevMap
Hashtable<InteropFramework.ProvFormat,String>	mimeTypeMap
Hashtable<String,InteropFramework.ProvFormat>	mimeTypeRevMap
Hashtable<InteropFramework.ProvFormat,InteropFramework.ProvFormatType>	provTypeMap
static String	UNKNOWN

Fields inherited from interface org.openprovenance.prov.interop.InteropMediaType

ALL_PROV_INPUT_MEDIA_TYPES, ALL_PROV_OUTPUT_MEDIA_TYPES, EXTENSION_DOT, EXTENSION_JPEG, EXTENSION_JPG, EXTENSION_JSON, EXTENSION_PDF, EXTENSION_PROVN, EXTENSION_PROVX, EXTENSION_RDF, EXTENSION_SVG, EXTENSION_TRIG, EXTENSION_TTL, EXTENSION_XML, MEDIA_APPLICATION_FORM_URLENCODED, MEDIA_APPLICATION_JSON, MEDIA_APPLICATION_PDF, MEDIA_APPLICATION_PROVENANCE_XML, MEDIA_APPLICATION_RDF_XML, MEDIA_APPLICATION_TRIG, MEDIA_APPLICATION_XML, MEDIA_IMAGE_JPEG, MEDIA_IMAGE_SVG_XML, MEDIA_TEXT_HTML, MEDIA_TEXT_PLAIN, MEDIA_TEXT_PROVENANCE_NOTATION, MEDIA_TEXT_TURTLE, MEDIA_TEXT_VND_GRAPHVIZ, MEDIA_TEXT_XML

Constructor Summary

Constructors

Constructor and Description
InteropFramework() Default constructor for the ProvToolbox interoperability framework.
InteropFramework(ProvFactory pFactory)
InteropFramework(String verbose, String debug, String logfile, String infile, String outfile, String namespaces, String title, String layout, String bindings, String generator, ProvFactory pFactory)

Method Summary

Methods

Modifier and Type	Method and Description
String	buildAcceptHeader() Create a list of mime types supported by ProvToolbox in view of constructing an Accept Header.
URLConnection	connectWithRedirect(URL theURL) A method to connect to a URL and follow redirects if any.
String	convertExtensionToMediaType(String extension) Maps an file extension to a Media type
String	getExtension(InteropFramework.ProvFormat format) Returns an extension for a given type of serialization of PROV
InteropFramework.ProvFormat	getTypeForFile(String filename) Get a InteropFramework.ProvFormat given the file's exetension
List<javax.ws.rs.core.Variant>	getVariants() Support for content negotiation, jax-rs style.
void	initializeExtensionMap(Hashtable<InteropFramework.ProvFormat,String> extensionMap, Hashtable<String,InteropFramework.ProvFormat> extensionRevMap) Initialization function
Boolean	isInputFormat(InteropFramework.ProvFormat format) Determines whether this format received as argument is an input format.
Boolean	isOutputFormat(InteropFramework.ProvFormat format) Determines whether this format received as argument is an output format.
Object	loadProvUnknownGraph(String filename) Experimental code, trying to load a document without knowing its serialization format.
static ProvFactory	newXMLProvFactory() Creates a factory for the XML Java beans.
void	provn2html(String file, String file2)
Document	readDocument(InputStream is, InteropFramework.ProvFormat format) Reads a Document from an input stream, using the parser specified by the format argument.
Document	readDocument(InputStream is, InteropFramework.ProvFormat format, ProvFactory pFactory) Reads a Document from an input stream, using the parser specified by the format argument.
Document	readDocument(String url) Reads a document from a URL.
Document	readDocumentFromFile(String filename) Reads a document from a file, using the file extension to decide which parser to read the file with.
void	run() Top level entry point of this class, when called from the command line.
void	setNamespaces(Document doc) Initializes a Document's namespace.
void	writeDocument(OutputStream os, InteropFramework.ProvFormat format, Document document) Write a Document to output stream, according to specified InteropFramework.ProvFormat
void	writeDocument(OutputStream os, javax.ws.rs.core.MediaType mt, Document document) Write a Document to output stream, according to specified Internet Media Type
void	writeDocument(String filename, Document document) Write a Document to file, serialized according to the file extension

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

UNKNOWN

public static final String UNKNOWN

See Also:

Constant Field Values

extensionMap

public final Hashtable<InteropFramework.ProvFormat,String> extensionMap

extensionRevMap

public final Hashtable<String,InteropFramework.ProvFormat> extensionRevMap

mimeTypeMap

public final Hashtable<InteropFramework.ProvFormat,String> mimeTypeMap

mimeTypeRevMap

public final Hashtable<String,InteropFramework.ProvFormat> mimeTypeRevMap

provTypeMap

public final Hashtable<InteropFramework.ProvFormat,InteropFramework.ProvFormatType> provTypeMap

Constructor Detail

InteropFramework

public InteropFramework()

Default constructor for the ProvToolbox interoperability framework. It uses ProvFactory as its default factory.

InteropFramework

public InteropFramework(ProvFactory pFactory)

InteropFramework

public InteropFramework(String verbose,
                String debug,
                String logfile,
                String infile,
                String outfile,
                String namespaces,
                String title,
                String layout,
                String bindings,
                String generator,
                ProvFactory pFactory)

Method Detail

buildAcceptHeader

public String buildAcceptHeader()

Create a list of mime types supported by ProvToolbox in view of constructing an Accept Header.

Returns:

a string representing the mime types.

connectWithRedirect

public URLConnection connectWithRedirect(URL theURL)
                                  throws IOException

A method to connect to a URL and follow redirects if any.

Parameters:

theURL - a URL to connect to

Returns:

a URLConnection

Throws:

IOException - if connection cannot be opened and no response is received.

convertExtensionToMediaType

public String convertExtensionToMediaType(String extension)

Maps an file extension to a Media type

Parameters:

extension - the extension of a file containing a serialization of PROV

Returns:

a String for the Internet Media type corresponding to a file with this extension

getExtension

public String getExtension(InteropFramework.ProvFormat format)

Returns an extension for a given type of serialization of PROV

Parameters:

format - InteropFramework.ProvFormat for which file extension is sought

Returns:

a String for the extension of a file containing such a serialization

getTypeForFile

public InteropFramework.ProvFormat getTypeForFile(String filename)

Get a InteropFramework.ProvFormat given the file's exetension

Parameters:

filename - the file for which the InteropFramework.ProvFormat is sought

Returns:

a InteropFramework.ProvFormat

getVariants

public List<javax.ws.rs.core.Variant> getVariants()

Support for content negotiation, jax-rs style. Create a list of media type supported by the framework.

See Also:

Content Negotiation

initializeExtensionMap

public void initializeExtensionMap(Hashtable<InteropFramework.ProvFormat,String> extensionMap,
                          Hashtable<String,InteropFramework.ProvFormat> extensionRevMap)

Initialization function

Parameters:

extensionMap - mapping of InteropFramework.ProvFormat to extensions

extensionRevMap - reverse mapping of extensions to InteropFramework.ProvFormat

isInputFormat

public Boolean isInputFormat(InteropFramework.ProvFormat format)

Determines whether this format received as argument is an input format.

Parameters:

format - a InteropFramework.ProvFormat

Returns:

true if format is an input format

isOutputFormat

public Boolean isOutputFormat(InteropFramework.ProvFormat format)

Determines whether this format received as argument is an output format.

Parameters:

format - a InteropFramework.ProvFormat

Returns:

true if format is an output format

loadProvUnknownGraph

public Object loadProvUnknownGraph(String filename)

Experimental code, trying to load a document without knowing its serialization format. First parser that succeeds returns a results. Not a robust method!

Parameters:

filename - a file to load the provenance document from

Returns:

a document

newXMLProvFactory

public static ProvFactory newXMLProvFactory()

Creates a factory for the XML Java beans.

Returns:

a ProvFactory

provn2html

public void provn2html(String file,
              String file2)
                throws IOException,
                       JAXBException,
                       org.antlr.runtime.RecognitionException

Throws:

IOException

JAXBException

org.antlr.runtime.RecognitionException

readDocument

public Document readDocument(InputStream is,
                    InteropFramework.ProvFormat format)

Reads a Document from an input stream, using the parser specified by the format argument.

Parameters:

is - an input stream

format - one of the input formats supported by ProvToolbox

Returns:

a Document

readDocument

public Document readDocument(InputStream is,
                    InteropFramework.ProvFormat format,
                    ProvFactory pFactory)

Reads a Document from an input stream, using the parser specified by the format argument.

Parameters:

is - an input stream

format - one of the input formats supported by ProvToolbox

pFactory - a provenance factory used to construct the Document

Returns:

a Document

readDocument

public Document readDocument(String url)

Reads a document from a URL. Uses the Content-type header field to determine the mime-type of the resource, and therefore the parser to read the document.

Parameters:

url - a URL

Returns:

a Document

readDocumentFromFile

public Document readDocumentFromFile(String filename)

Reads a document from a file, using the file extension to decide which parser to read the file with.

Parameters:

filename - the file to read a document from

Returns:

a Document

run

public void run()

Top level entry point of this class, when called from the command line.

See method CommandLineArguments.main(String[])

setNamespaces

public void setNamespaces(Document doc)

Initializes a Document's namespace.

writeDocument

public void writeDocument(OutputStream os,
                 javax.ws.rs.core.MediaType mt,
                 Document document)

Write a Document to output stream, according to specified Internet Media Type

Parameters:

os - an OutputStream to write the Document to

mt - a MediaType

document - a Document to serialize

writeDocument

public void writeDocument(OutputStream os,
                 InteropFramework.ProvFormat format,
                 Document document)

Write a Document to output stream, according to specified InteropFramework.ProvFormat

Parameters:

os - an OutputStream to write the Document to

format - a InteropFramework.ProvFormat

document - a Document to serialize

writeDocument

public void writeDocument(String filename,
                 Document document)

Write a Document to file, serialized according to the file extension

Parameters:

filename - path of the file to write the Document to

document - a Document to serialize