Class SearchablePropertyReport

  • All Implemented Interfaces:
    Report, XmlSerializable

    public class SearchablePropertyReport
    extends AbstractReport
    SearchablePropertyReport identifies those properties that may be searched using the DAV:principal-property-search REPORT. This report must be supported on all collections identified in the value of a DAV:principal-collection-set property.

    The request body MUST be an empty DAV:principal-search-property-set element.

    The response body MUST be a DAV:principal-search-property-set XML element with the following structure:

      <!ELEMENT principal-search-property-set (principal-search-property*) >
      <!ELEMENT principal-search-property (prop, description) >
      prop: see RFC 2518, Section 12.11
      <!ELEMENT description #PCDATA >
      Human readable description. Note, that the language of the description must
      be indicated by the xml:lang attribute.
     
    Note that a DAV:principal-search-property XML element is required for each property that may be searched with the DAV:principal-property-search REPORT.
    • Method Summary

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      void addPrincipalSearchProperty​(DavPropertyName propName, java.lang.String description, java.lang.String language)
      Add a property name that should be listed in the DAV:principal-search-property-set.
      ReportType getType()
      Returns the registered type of this report.
      void init​(DavResource resource, ReportInfo info)
      Set the DeltaVResource for which this report was requested and the ReportInfo as specified by the REPORT request body, that defines the details for this report.
      Please note that this methods should perform basic validation checks in order to prevent exceptional situations during the xml serialization.
      boolean isMultiStatusReport()
      Returns true if this Report will send a MultiStatus response.
      Please note that RFC 3253 that the the response must be a 207 Multi-Status, if a Depth request header is present.
      org.w3c.dom.Element toXml​(org.w3c.dom.Document document)
      Returns the xml representation of the implementing object as Element.
      • Methods inherited from class java.lang.Object

        equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • Field Detail

      • REPORT_NAME

        public static final java.lang.String REPORT_NAME
        The report name
        See Also:
        Constant Field Values
      • REPORT_TYPE

        public static final ReportType REPORT_TYPE
        The report type
      • XML_PRINCIPAL_SEARCH_PROPERTY_SET

        public static final java.lang.String XML_PRINCIPAL_SEARCH_PROPERTY_SET
        Constant used for the DAV:principal-search-property-set response element.
        See Also:
        Constant Field Values
    • Constructor Detail

      • SearchablePropertyReport

        public SearchablePropertyReport()
    • Method Detail

      • getType

        public ReportType getType()
        Description copied from interface: Report
        Returns the registered type of this report.
        Returns:
        the type of this report.
        See Also:
        Report.getType()
      • isMultiStatusReport

        public boolean isMultiStatusReport()
        Description copied from interface: Report
        Returns true if this Report will send a MultiStatus response.
        Please note that RFC 3253 that the the response must be a 207 Multi-Status, if a Depth request header is present.
        Returns:
        false Status code of after a successful completion must be 200 (ok).
        See Also:
        Report.isMultiStatusReport()
      • init

        public void init​(DavResource resource,
                         ReportInfo info)
                  throws DavException
        Description copied from interface: Report
        Set the DeltaVResource for which this report was requested and the ReportInfo as specified by the REPORT request body, that defines the details for this report.
        Please note that this methods should perform basic validation checks in order to prevent exceptional situations during the xml serialization.
        Throws:
        DavException
        See Also:
        Report.init(DavResource, ReportInfo)
      • toXml

        public org.w3c.dom.Element toXml​(org.w3c.dom.Document document)
        Description copied from interface: XmlSerializable
        Returns the xml representation of the implementing object as Element. The given Document is used as factory and represents the owner document of the returned DOM element.
        Parameters:
        document - to be used as factory.
        Returns:
        a w3c element representing this object
        See Also:
        XmlSerializable.toXml(Document)
      • addPrincipalSearchProperty

        public void addPrincipalSearchProperty​(DavPropertyName propName,
                                               java.lang.String description,
                                               java.lang.String language)
        Add a property name that should be listed in the DAV:principal-search-property-set.
        Parameters:
        propName - a property name that may be searched in the PrincipalSearchReport.
        description - Human readable description of the searchable property.
        language - defines in which language the description is written.
        Throws:
        java.lang.IllegalArgumentException - if propName is null.