Page tree

Old Release

This documentation covers an old version of Fedora. Looking for another version? See all documentation.

Skip to end of metadata
Go to start of metadata

To configure an external PID minter, create a Spring bean configuration file using the HttpPidMinter class, and use a system property to use it instead of the internal PID minter:

-Dfcrepo.minter.config=file:///path/to/minter.xml -Dfcrepo.minter.username=minterUser -Dfcrepo.minter.password=minterPass

Example minter.xml:

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:c="http://www.springframework.org/schema/c"
    xsi:schemaLocation="http://www.springframework.org/schema/beans
        http://www.springframework.org/schema/beans/spring-beans-3.0.xsd">

    <bean class="org.fcrepo.kernel.identifiers.HttpPidMinter"
        c:url="http://localhost/my/minter" c:method="POST"
        c:username="${fcrepo.minter.username:minterUsername}"
        c:password="${fcrepo.minter.password:minterPassword}"
        c:regex="" c:xpath="/response/ids/value"/>

</beans>

The properties that can be set are:

  • url (required): The URL of the external minter REST service.
  • method: The HTTP method to use to generate a new identifier: GET, POST, or PUT.  If not specified, POST is used.
  • username/password: The username and password to use for connecting to the minter REST service.  You may want to pass the username/password using System properties instead of hard-coding them in the config file (the example above shows how to use a System property with a fallback value if the property is not set).  If not specified, no authentication is used.
  • regex: If set, remove text matching the regular expression from the minter service response.  For example, if the minter response is "id: foo/abc123", the regular expression ".*/" would remove the "id: foo/" and result in the identifier "abc123".
  • xpath: If set, parse the minter service response as XML and use XPath to get the identifier value to use.
  • No labels