com.marklogic.hub.dataservices

Interface MappingService

public interface MappingService

Provides a set of operations on the database server

Method Summary

Modifier and Type	Method and Description
void	generateMappingTransforms() Generates a transform in the modules database for each legacy mapping or mapping step
java.lang.String	getDocument(java.lang.String stepName, java.lang.String uri) Gets the document based on the given URI from the source database associated with the given step name
com.fasterxml.jackson.databind.JsonNode	getDocumentForTesting(java.lang.String stepName, java.lang.String uri) Get an XML or JSON source document (and additional information all formatted as a string of JSON) to facilitate testing a map.
com.fasterxml.jackson.databind.JsonNode	getMappingFunctions() Invokes the getMappingFunctions operation on the database server
com.fasterxml.jackson.databind.JsonNode	getUris(java.lang.String stepName, java.lang.Integer limit) Gets the list of URIs that match the 'sourceQuery' from source db associated with given step name.
static MappingService	on(com.marklogic.client.DatabaseClient db) Creates a MappingService object for executing operations on the database server.
static MappingService	on(com.marklogic.client.DatabaseClient db, com.marklogic.client.io.marker.JSONWriteHandle serviceDeclaration) Creates a MappingService object for executing operations on the database server.
com.fasterxml.jackson.databind.JsonNode	testMapping(java.lang.String uri, java.lang.String database, com.fasterxml.jackson.databind.JsonNode jsonMapping) Invokes the testMapping operation on the database server

Method Detail

on

static MappingService on(com.marklogic.client.DatabaseClient db)

Creates a MappingService object for executing operations on the database server. The DatabaseClientFactory class can create the DatabaseClient parameter. A single client object can be used for any number of requests and in multiple threads.

Parameters:

db - provides a client for communicating with the database server

Returns:

an object for executing database operations

on

static MappingService on(com.marklogic.client.DatabaseClient db,
                         com.marklogic.client.io.marker.JSONWriteHandle serviceDeclaration)

Creates a MappingService object for executing operations on the database server. The DatabaseClientFactory class can create the DatabaseClient parameter. A single client object can be used for any number of requests and in multiple threads. The service declaration uses a custom implementation of the same service instead of the default implementation of the service by specifying an endpoint directory in the modules database with the implementation. A service.json file with the declaration can be read with FileHandle or a string serialization of the JSON declaration with StringHandle.

Parameters:

db - provides a client for communicating with the database server

serviceDeclaration - substitutes a custom implementation of the service

Returns:

an object for executing database operations

testMapping

com.fasterxml.jackson.databind.JsonNode testMapping(java.lang.String uri,
                                                    java.lang.String database,
                                                    com.fasterxml.jackson.databind.JsonNode jsonMapping)

Invokes the testMapping operation on the database server

Parameters:

uri - provides input

database - provides input

jsonMapping - provides input

Returns:

as output

getDocument

java.lang.String getDocument(java.lang.String stepName,
                             java.lang.String uri)

Gets the document based on the given URI from the source database associated with the given step name

Parameters:

stepName - provides input

uri - provides input

Returns:

as output

getUris

com.fasterxml.jackson.databind.JsonNode getUris(java.lang.String stepName,
                                                java.lang.Integer limit)

Gets the list of URIs that match the 'sourceQuery' from source db associated with given step name. The uri count is specified by 'limit' parameter

Parameters:

stepName - provides input

limit - provides input

Returns:

as output

getDocumentForTesting

com.fasterxml.jackson.databind.JsonNode getDocumentForTesting(java.lang.String stepName,
                                                              java.lang.String uri)

Get an XML or JSON source document (and additional information all formatted as a string of JSON) to facilitate testing a map.

Parameters:

stepName - provides input

uri - provides input

Returns:

as output

generateMappingTransforms

void generateMappingTransforms()

Generates a transform in the modules database for each legacy mapping or mapping step

getMappingFunctions

com.fasterxml.jackson.databind.JsonNode getMappingFunctions()

Invokes the getMappingFunctions operation on the database server

Returns:

as output