org.w3.ldp.testsuite.test

Class LdpTest

java.lang.Object

org.w3.ldp.testsuite.test.LdpTest

Direct Known Subclasses:

CommonResourceTest, PagingTest

public abstract class LdpTest
extends Object

Field Summary

Fields

Modifier and Type	Field and Description
static String	DEFAULT_MODEL_TYPE
static DateFormat	df
static String	HTTP_LOG_FILENAME
protected static PrintWriter	httpLog For HTTP details on validation failures
static String	MANUAL A grouping of tests that may not need to run as part of the regular TestNG runs.
static String	MAY An item is truly optional.
static String	MUST An absolute requirement of the specification.
static String	SHOULD There may exist valid reasons in particular circumstances to ignore a particular item, but the full implications must be understood and carefully weighed before choosing a different course.
protected static PrintWriter	skipLog For skipped test logging
static String	SKIPPED_LOG_FILENAME

Constructor Summary

Constructors

Constructor and Description
LdpTest()

Method Summary

Methods

Modifier and Type	Method and Description
protected abstract com.jayway.restassured.specification.RequestSpecification	buildBaseRequestSpecification() Build a base RestAssured RequestSpecification.
protected void	checkPreferenceAppliedHeader(com.jayway.restassured.response.Response response) Asserts the response has a Preference-Applied: return=representation response header, but only if at least one Preference-Applied header is present.
void	commonSetup(String outputDir, String postTtl, String httpLogging, String skipLogging) Initialization of generic resource model.
void	commonTearDown()
protected boolean	containsLinkHeader(String linkContext, String relation, String linkTarget, String requestUri, com.jayway.restassured.response.Response response) Tests if a Link response header with the expected context URI, link relation, and target URI is present in an HTTP response.
com.hp.hpl.jena.rdf.model.Model	getAsModel(String uri)
protected com.hp.hpl.jena.rdf.model.Model	getDefaultModel()
protected String	getFirstLinkForRelation(String linkContext, String relation, String requestUri, com.jayway.restassured.response.Response response) Gets the first link from response with link relation rel.
protected com.hp.hpl.jena.rdf.model.Resource	getPrimaryTopic(com.hp.hpl.jena.rdf.model.Model model, String location) Given the location (URI), locate the appropriate "primary" resource within the model.
com.hp.hpl.jena.rdf.model.Model	getResourceAsModel(String uri, String mediaType)
protected boolean	hasReturnRepresentation(List<com.jayway.restassured.response.Header> preferenceAppliedHeaders)
static String	include(String... preferences)
static String	omit(String... preferences)
protected com.hp.hpl.jena.rdf.model.Model	postContent()
protected com.hp.hpl.jena.rdf.model.Model	readModel(String path) Builds a model from a turtle representation in a file
static String	resolveIfRelative(String base, String toResolve) Resolves a URI if it's a relative path.
protected static String	resolveIfRelative(String base, URI toResolve)
protected boolean	restrictionsOnPostContent() Are there any restrictions on content when creating resources? This is assumed to be true if POST content was provided using the postTtl test parameter.
protected List<String>	splitLinks(com.jayway.restassured.response.Header linkHeader) Splits an HTTP Link header that might have multiple links separated by a comma.

Methods inherited from class java.lang.Object

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

Field Detail

SKIPPED_LOG_FILENAME

public static final String SKIPPED_LOG_FILENAME

See Also:

Constant Field Values

HTTP_LOG_FILENAME

public static final String HTTP_LOG_FILENAME

See Also:

Constant Field Values

df

public static final DateFormat df

DEFAULT_MODEL_TYPE

public static final String DEFAULT_MODEL_TYPE

See Also:

Constant Field Values

httpLog

protected static PrintWriter httpLog

For HTTP details on validation failures

skipLog

protected static PrintWriter skipLog

For skipped test logging

MUST

public static final String MUST

An absolute requirement of the specification.

See Also:

RFC 2119, Constant Field Values

SHOULD

public static final String SHOULD

There may exist valid reasons in particular circumstances to ignore a particular item, but the full implications must be understood and carefully weighed before choosing a different course.

See Also:

RFC 2119, Constant Field Values

MAY

public static final String MAY

An item is truly optional. One vendor may choose to include the item because a particular marketplace requires it or because the vendor feels that it enhances the product while another vendor may omit the same item.

See Also:

RFC 2119, Constant Field Values

MANUAL

public static final String MANUAL

A grouping of tests that may not need to run as part of the regular TestNG runs. Though by including it, it will allow for the generation via various reporters.

See Also:

Constant Field Values

Constructor Detail

LdpTest

public LdpTest()

Method Detail

readModel

protected com.hp.hpl.jena.rdf.model.Model readModel(String path)

Builds a model from a turtle representation in a file

Parameters:

path -

commonSetup

public void commonSetup(String outputDir,
               String postTtl,
               String httpLogging,
               String skipLogging)
                 throws IOException

Initialization of generic resource model. This will run only once at the beginning of the test suite, so postModel static field will be assigned once too.

Parameters:

postTtl - the resource with Turtle content to use for POST requests

httpLogging - whether to log HTTP request and response details on errors

Throws:

IOException

commonTearDown

public void commonTearDown()

buildBaseRequestSpecification

protected abstract com.jayway.restassured.specification.RequestSpecification buildBaseRequestSpecification()

Build a base RestAssured RequestSpecification.

Returns:

RestAssured Request Specification

getAsModel

public com.hp.hpl.jena.rdf.model.Model getAsModel(String uri)

getResourceAsModel

public com.hp.hpl.jena.rdf.model.Model getResourceAsModel(String uri,
                                                 String mediaType)

getDefaultModel

protected com.hp.hpl.jena.rdf.model.Model getDefaultModel()

getPrimaryTopic

protected com.hp.hpl.jena.rdf.model.Resource getPrimaryTopic(com.hp.hpl.jena.rdf.model.Model model,
                                                 String location)

Given the location (URI), locate the appropriate "primary" resource within the model. Often models will have many triples with various subjects, which don't always match the request-URI. This attempts to resolve to the appropriate resource for the request-URI. This method is used to determine which subject URI should be used to assign new triples to for tests such as PUT.

Parameters:

model -

location -

Returns:

postContent

protected com.hp.hpl.jena.rdf.model.Model postContent()

restrictionsOnPostContent

protected boolean restrictionsOnPostContent()

Are there any restrictions on content when creating resources? This is assumed to be true if POST content was provided using the postTtl test parameter.

This method is used for CommonContainerTest.testRelativeUriResolutionPost(String).

Returns:

true if there are restrictions on what triples are allowed; false if the server allows most any RDF

See Also:

RdfSourceTest.restrictionsOnTestResourceContent()

containsLinkHeader

protected boolean containsLinkHeader(String linkContext,
                         String relation,
                         String linkTarget,
                         String requestUri,
                         com.jayway.restassured.response.Response response)

Tests if a Link response header with the expected context URI, link relation, and target URI is present in an HTTP response. Resolves relative URIs against the request URI if necessary.

Parameters:

linkContext - the context of the Link (usually the request URI, but can be changed with an anchor parameter)

relation - the expected link relation (rel)

linkTarget - the expected URI

requestUri - the HTTP request URI (for determing a Link's context and resolving relative URIs)

response - the HTTP response

See Also:

RFC 5988

getFirstLinkForRelation

protected String getFirstLinkForRelation(String linkContext,
                             String relation,
                             String requestUri,
                             com.jayway.restassured.response.Response response)

Gets the first link from response with link relation rel. Resolves relative URIs against the request URI if necessary.

Parameters:

linkContext - the context of the Link (usually the request URI, but can be changed with an anchor parameter)

relation - the expected link relation

requestUri - the HTTP request URI (for determing a Link's context and resolving relative URIs)

response - the HTTP response

Returns:

the first link or null if none was found

See Also:

RFC 5988

splitLinks

protected List<String> splitLinks(com.jayway.restassured.response.Header linkHeader)

Splits an HTTP Link header that might have multiple links separated by a comma.

Parameters:

linkHeader - the link header

Returns:

the list of link-values as defined in RFC 5988 (for example, "<http://example.com/bt/bug432>; rel=related")

See Also:

RFC 5988: The Link Header Field

checkPreferenceAppliedHeader

protected void checkPreferenceAppliedHeader(com.jayway.restassured.response.Response response)

Asserts the response has a Preference-Applied: return=representation response header, but only if at least one Preference-Applied header is present.

Parameters:

response - the HTTP response

hasReturnRepresentation

protected boolean hasReturnRepresentation(List<com.jayway.restassured.response.Header> preferenceAppliedHeaders)

include

public static String include(String... preferences)

omit

public static String omit(String... preferences)

resolveIfRelative

public static String resolveIfRelative(String base,
                       String toResolve)

Resolves a URI if it's a relative path.

Parameters:

base - the base URI to use

toResolve - a URI that might be relative

Returns:

the resolved URI

resolveIfRelative

protected static String resolveIfRelative(String base,
                       URI toResolve)