Package eu.clarin.sru.client

Class SRUExplainRequest

    • Constructor Detail

      • SRUExplainRequest

        public SRUExplainRequest​(URI baseURI)
        Constructor.
        Parameters:
        baseURI - the baseURI of the endpoint

      • SRUExplainRequest

        public SRUExplainRequest​(String baseURI)
        Constructor.
        Parameters:
        baseURI - the baseURI of the endpoint

    • Method Detail

      • getRecordXmlEscaping

        public SRURecordXmlEscaping getRecordXmlEscaping()
        Get the recordXmlEscpaing (SRU 2.0) or recordPacking (SRU 1.1 and SRU 1.2) parameter of this request.
        Returns:
        the requested record packing
        See Also:
        SRURecordXmlEscaping

      • setRecordXmlEscaping

        public void setRecordXmlEscaping​(SRURecordXmlEscaping getRecordXmlEscaping)
        Set the recordXmlEscpaing (SRU 2.0) or recordPacking (SRU 1.1 and SRU 1.2) parameter of this request.
        Parameters:
        getRecordXmlEscaping - the requested record XML escaping
        See Also:
        SRURecordXmlEscaping

      • isParseRecordDataEnabled

        public boolean isParseRecordDataEnabled()
        Check, whether the record data of a explain response (ZeeRex record) shall be parsed or not.
        Returns:
        true if parsing is enabled, false otherwise

      • setParseRecordDataEnabled

        public void setParseRecordDataEnabled​(boolean enabled)
        Enable or disable parsing of explain record data (ZeeRex record) of the explain response.
        Parameters:
        enabled - true enabled parsing, false disables parsing

      • getOperation

        public SRUOperation getOperation()
        Note: this method is not a part of public API.
        Returns:
        a operation constant for this request

      • getBaseURI

        public URI getBaseURI()
        Get the baseURI of the SRU server.
        Returns:
        the baseURI of the SRU server

      • isStrictMode

        public boolean isStrictMode()
        Get the SRU protocol conformance mode for this request
        Returns:
        true if the request will be performed in strict mode, false if the request will be performed in a more tolerant mode

      • setStrictMode

        public void setStrictMode​(boolean strictMode)
        Set the SRU protocol conformance mode for this request
        Parameters:
        strictMode - true if the request should be performed in strict mode, false if the request should be performed client should in a more tolerant mode

      • setVersion

        public void setVersion​(SRUVersion version)
        Set the version for this request.
        Parameters:
        version - a version of null for client default

      • getVersion

        public SRUVersion getVersion()
        Get the version for this request.
        Returns:
        version for this request or null if client default is used

      • getExtraRequestData

        public String getExtraRequestData​(String name)
        Set the value of extra request parameter for this request.
        Parameters:
        name - the name for the extra request data parameter
        Returns:
        the value for the extra request data parameter or null if parameter was not set
        Throws:
        NullPointerException - if any required argument is null
        IllegalArgumentException - if any argument is invalid
        See Also:
        SRU Extra Data / Extensions

      • getRequestedURI

        public final URI getRequestedURI()
        Get the URI that was used to perform the request. This method may only be called after the request was carried out, otherwise it will throw an IllegalStateException.
        Returns:
        the URI that was used to carry out this request
        Throws:
        IllegalStateException - if the request was not yet carried out

      • getRequestedVersion

        public final SRUVersion getRequestedVersion()
        Get the version that was used to carry out this request. This method may only be called after the request was carried out, otherwise it will throw an IllegalStateException.
        Returns:
        the version that was used to carry out this request
        Throws:
        IllegalStateException - if the request was not yet carried out

      • isSendAuthentication

        public boolean isSendAuthentication()
        Get the authentication mode for this request
        Returns:
        true if the request will try to send authentication data (header), false if the request will not send send authentication information

      • setSendAuthentication

        public void setSendAuthentication​(boolean sendAuthentication)
        Set whether authentication information should be sent for this request
        Parameters:
        sendAuthentication - true if the request should try to send authentication information, false if sending should be suppressed

      • getAuthenticationContext

        public Map<String,​String> getAuthenticationContext()
        Returns a nullable read-only map of authentication context data.
        Returns:
        the authentication context map or null if no entries were created

      • setAuthenticationContext

        public void setAuthenticationContext​(String name,
                                     String value)
        Set an authentication context entry for this request.
        Parameters:
        name - the name for the context entry parameter
        value - the value for the context entry parameter
        Throws:
        NullPointerException - if any required argument is null
        IllegalArgumentException - if any argument is invalid