eu.europeana.cloud.service.commons.urls

Class UrlParser

java.lang.Object

eu.europeana.cloud.service.commons.urls.UrlParser

public class UrlParser
extends Object

Parser for URL used in eCloud API.


Some of possible URL patterns are:

http://www.example.com/data-providers/DATAPROVIDER/data-sets/ http://www.example.com/data-providers/DATAPROVIDER/data-sets/DATASET/ http://www.example.com/data-providers/DATAPROVIDER/data-sets/DATASET/assignments/ http://www.example.com/records/CLOUDID/ http://www.example.com/records/CLOUDID/representations/ http://www.example.com/records/CLOUDID/representations/REPRESENTATIONNAME/ http://www.example.com/records/CLOUDID/representations/REPRESENTATIONNAME/versions/ http://www.example.com/records/CLOUDID/representations/REPRESENTATIONNAME/versions/VERSION/ http://www.example.com/records/CLOUDID/representations/REPRESENTATIONNAME/versions/VERSION/copy/ http://www.example.com/records/CLOUDID/representations/REPRESENTATIONNAME/versions/VERSION/permit/ http://www.example.com/records/CLOUDID/representations/REPRESENTATIONNAME/versions/VERSION/persist/ http://www.example.com/records/CLOUDID/representations/REPRESENTATIONNAME/versions/VERSION/users/username/permit/permission/ http://www.example.com/records/CLOUDID/representations/REPRESENTATIONNAME/versions/VERSION/files/ http://www.example.com/records/CLOUDID/representations/REPRESENTATIONNAME/versions/VERSION/files/FILENAME/

Constructor Summary

Constructors

Constructor and Description
UrlParser(String url)

Method Summary

Methods

Modifier and Type	Method and Description
String	getDataSetsUrl()
String	getPart(UrlPart urlPart) Returns one part of given URL.
String	getVersionsUrl()
String	getVersionUrl() Returns URL to version based on provided URL.
boolean	isUrlToCloudId() Checks if given URL points to representations list E.g.
boolean	isUrlToDataset() Checks if given URL points to data-set E.g.
boolean	isUrlToDatasetsList() Checks if given URL points to data-sets list E.g.
boolean	isUrlToRepresentation() Checks if given URL points to representation E.g.
boolean	isUrlToRepresentations() Checks if given URL points to representations list E.g.
boolean	isUrlToRepresentationVersion() Checks if given URL points to representation version E.g.
boolean	isUrlToRepresentationVersionFile() Checks if given URL points to file. E.g.
boolean	isUrlToRepresentationVersionFiles() Checks if given URL points to files list. E.g.
boolean	isUrlToRepresentationVersions() Checks if given URL points to representation versions list E.g.

Methods inherited from class java.lang.Object

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

Constructor Detail

UrlParser

public UrlParser(String url)
          throws MalformedURLException

Throws:

MalformedURLException

Method Detail

isUrlToDatasetsList

public boolean isUrlToDatasetsList()

Checks if given URL points to data-sets list

E.g. http://www.example.com/data-providers/DATAPROVIDER/data-sets/

Returns:

isUrlToDataset

public boolean isUrlToDataset()

Checks if given URL points to data-set

E.g. http://www.example.com/data-providers/DATAPROVIDER/data-sets/DATASET/

Returns:

isUrlToCloudId

public boolean isUrlToCloudId()

Checks if given URL points to representations list
E.g. http://www.example.com/records/CLOUDID/

Returns:

isUrlToRepresentations

public boolean isUrlToRepresentations()

Checks if given URL points to representations list
E.g. http://www.example.com/records/CLOUDID/representations/

Returns:

isUrlToRepresentation

public boolean isUrlToRepresentation()

Checks if given URL points to representation
E.g. http://www.example.com/records/CLOUDID/representations/REPRESENTATIONNAME/

Returns:

isUrlToRepresentationVersions

public boolean isUrlToRepresentationVersions()

Checks if given URL points to representation versions list
E.g. http://www.example.com/records/CLOUDID/representations/REPRESENTATIONNAME/versions

Returns:

isUrlToRepresentationVersion

public boolean isUrlToRepresentationVersion()

Checks if given URL points to representation version
E.g. http://www.example.com/records/CLOUDID/representations/REPRESENTATIONNAME/versions/VERSION

Returns:

isUrlToRepresentationVersionFiles

public boolean isUrlToRepresentationVersionFiles()

Checks if given URL points to files list.
E.g. http://127.0.0.1:8080/mcs/records/FUWQ4WMUGIGEHVA3X7FY5PA3DR5Q4B2C4TWKNILLS6EM4SJNTVEQ/representations/TIFF/versions/86318b00-6377-11e5-a1c6-90e6ba2d09ef/files

Returns:

isUrlToRepresentationVersionFile

public boolean isUrlToRepresentationVersionFile()

Checks if given URL points to file.
E.g. http://127.0.0.1:8080/mcs/records/FUWQ4WMUGIGEHVA3X7FY5PA3DR5Q4B2C4TWKNILLS6EM4SJNTVEQ/representations/TIFF/versions/86318b00-6377-11e5-a1c6-90e6ba2d09ef/files/sampleFileName.txt

Returns:

getPart

public String getPart(UrlPart urlPart)

Returns one part of given URL. If requested part does not exist, null will be returned

Parameters:

urlPart - which one part should be returned.

Returns:

getVersionUrl

public String getVersionUrl()
                     throws UrlBuilderException

Returns URL to version based on provided URL. If it is not possible UrlBuilderException will be thrown

Returns:

Throws:

UrlBuilderException

getVersionsUrl

public String getVersionsUrl()
                      throws UrlBuilderException

Throws:

UrlBuilderException

getDataSetsUrl

public String getDataSetsUrl()
                      throws UrlBuilderException

Throws:

UrlBuilderException