Class SimpleDatabase

  • All Implemented Interfaces:
    Configurable, Database
    Direct Known Subclasses:
    DatabaseImpl

    public abstract class SimpleDatabase
    extends SimpleConfigurable
    implements Database
    Simple Database implementation intended to be used as a base class for a specific implementation.

    Extending classes MUST set INSTANCE_NAME and SHOULD set CONFORMANCE_LEVEL to values appropriate for their specific implementation.

    • Constructor Summary

      Constructors 
      Constructor Description
      SimpleDatabase()  
    • Method Summary

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      boolean acceptsURI​(java.lang.String uri)
      acceptsURI determines whether this Database implementation can handle the URI.
      Collection getCollection​(java.lang.String uri, java.lang.String username, java.lang.String password)
      Retrieves a Collection instance based on the URI provided in the uri parameter.
      java.lang.String getConformanceLevel()
      Returns the XML:DB API Conformance level for the implementation.
      java.lang.String getName()
      Returns the name associated with the Configurable object.
      java.lang.String[] getNames()
      Returns an array of names associated with the Database instance.
      • Methods inherited from class java.lang.Object

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

      • SimpleDatabase

        public SimpleDatabase()
    • Method Detail

      • getName

        public java.lang.String getName()
                                 throws XMLDBException
        Returns the name associated with the Configurable object.
        Specified by:
        getName in interface Database
        Returns:
        the name of the object.
        Throws:
        XMLDBException - with expected error codes.
        ErrorCodes.VENDOR_ERROR for any vendor specific errors that occur.
      • getNames

        public java.lang.String[] getNames()
                                    throws XMLDBException
        Description copied from interface: Database
        Returns an array of names associated with the Database instance.
        Specified by:
        getNames in interface Database
        Returns:
        the array of name of the object.
        Throws:
        XMLDBException - with expected error codes.
        ErrorCodes.VENDOR_ERROR for any vendor specific errors that occur.
      • getCollection

        public Collection getCollection​(java.lang.String uri,
                                        java.lang.String username,
                                        java.lang.String password)
                                 throws XMLDBException
        Retrieves a Collection instance based on the URI provided in the uri parameter. Implementations must override this method.
        Specified by:
        getCollection in interface Database
        Parameters:
        uri - the URI to use to locate the collection.
        password - The password to use for authentication to the database or null if the database does not support authentication.
        Returns:
        The Collection instance
        Throws:
        XMLDBException - with expected error codes.
        ErrorCodes.VENDOR_ERROR for any vendor specific errors that occur.
        ErrroCodes.INVALID_URI If the URI is not in a valid format.
        ErrroCodes.PERMISSION_DENIED If the username and password were not accepted by the database.
      • acceptsURI

        public boolean acceptsURI​(java.lang.String uri)
                           throws XMLDBException
        acceptsURI determines whether this Database implementation can handle the URI.
        Specified by:
        acceptsURI in interface Database
        Parameters:
        uri - the URI to check for.
        Returns:
        true if the URI can be handled, false otherwise.
        Throws:
        XMLDBException - with expected error codes.
        ErrorCodes.VENDOR_ERROR for any vendor specific errors that occur.
        ErrroCodes.INVALID_URI If the URI is not in a valid format.
      • getConformanceLevel

        public java.lang.String getConformanceLevel()
                                             throws XMLDBException
        Returns the XML:DB API Conformance level for the implementation.
        Specified by:
        getConformanceLevel in interface Database
        Returns:
        the XML:DB API conformance level for this implementation.
        Throws:
        XMLDBException - with expected error codes.
        ErrorCodes.VENDOR_ERROR for any vendor specific errors that occur.