Examples of com.google.k2crypto.storage.driver.Driver

Package com.google.k2crypto.storage.driver

Examples of com.google.k2crypto.storage.driver.Driver

com.google.k2crypto.storage.driver.Driver
Main driver interface for a key storage location.
Drivers are concrete implementations of a {@link Store}. In addition to implementing this interface, the instantiatable driver class must be annotated with {@link DriverInfo}, provide a public constructor with no arguments and implement {@link ReadableDriver} and/or{@link WritableDriver} depending on the operations supported. For example,a driver that only allows importing of Keys would only implement {@link ReadableDriver}. The {@link WrappingDriver} interface should be implemented for drivers that support wrapping/unwrapping of Keys.
When instantiated, {@link #initialize(K2Context)} will be invoked on thedriver to provide the context of the current K2 session. After a successful initialization, {@link #open(URI)} will be called to actually allocateresources for performing storage operations on the specified storage address. This method may throw {@link IllegalAddressException} if the address is notrecognized by the driver. Finally, {@link #close()} will be called to freeresources, after the user has performed the storage operations. Note that it is NOT safe to allocate resources before {@link #open(URI)} is called,e.g. during construction or on initialize.
Drivers need not be concerned with thread safety, or methods invoked when they are not supported, or methods invoked when {@link #open(URI)} has notbeen called, or methods invoked when {@link #close()} has been called. The{@link Store} wrapper will manage all access to the driver by ensuring thatcalls are synchronized, methods are not invoked when inappropriate, etc.
A note about open/close and network-based stores: It is possible for the network connection to drop after the driver is opened. However, the driver must not implicitly close the store in this event. As long as the store is still open, the connection should be reattempted. @author darylseah@gmail.com (Daryl Seah)

   * @param address URI address to open.
   * @param reason Reason the address is rejected.
   */
  protected void checkRejectAddress(
      URI address, IllegalAddressException.Reason reason) {
    Driver driver = newDriver();
    try {
      driver.open(address);
      fail("Should reject " + address);
    } catch (StoreException ex) {
      throw new AssertionError("Unexpected", ex);
    } catch (IllegalAddressException expected) {
      assertEquals(reason, expected.getReason());
      assertEquals(address.toString(), expected.getAddress());
    } finally {
      driver.close();
    }
  }

View Full Code Here

   * 
   * @throws K2Exception if there is an unexpected failure opening the address.
   */
  protected void checkNormalization(String expected, String address)
      throws K2Exception {
    Driver driver = newDriver();
    try {
      URI result = driver.open(URI.create(address));
      assertEquals(expected, result.toString());
    } finally {
      driver.close();
    }
  }

View Full Code Here

   * Instantiates a new store (driver) from the driver installation.
   */
  Driver instantiate() {
    try {
      // Use reflection to instantiate the driver
      Driver driver = constructor.newInstance();
      driver.initialize(context);
      return driver;
    } catch (InvocationTargetException ex) {
      Throwable t = ex.getCause();
      // Re-throw throwables that do not need an explicit catch. (This should
      // not actually happen unless the driver has a flaky constructor.)

View Full Code Here

      checkRejectAddress(
          generateAddress(db, oneCharTooLongId),
          IllegalAddressException.Reason.INVALID_FRAGMENT);


      // Test acceptance of identifier at maximum length
      Driver driver = newDriver();
      try {
        driver.open(generateAddress(db, generateString(MAX_KEY_ID_LENGTH)));
      } finally {
        driver.close();
      }  
    } finally {
      db.delete();
    }
  }

View Full Code Here

      Class<? extends Driver> driverClass) throws StorageDriverException {
    InstalledDriver idriver = new InstalledDriver(context, driverClass);
    assertEquals(context, idriver.getContext());
    assertEquals(driverClass, idriver.getDriverClass());
    assertEquals(driverClass.hashCode(), idriver.hashCode());
    Driver driver = idriver.instantiate();
    assertTrue(driverClass.isInstance(driver));
    assertEquals(context, ((MockDriver)driver).context);
    return idriver;
  }

View Full Code Here

    checkRejectAddress(
        testingAddress + oneCharTooLongName,
        IllegalAddressException.Reason.INVALID_PATH);
    
    // Test acceptance of filename at maximum length
    Driver driver = newDriver();
    try {
      driver.open(URI.create(
          testingAddress + generateString(MAX_FILENAME_LENGTH)));
    } finally {
      driver.close();
    }  
  }

View Full Code Here

TOP

Related Classes of com.google.k2crypto.storage.driver.Driver

com.google.k2crypto.storage.driver.BasicDriverTest

com.google.k2crypto.storage.driver.impl.K2FileSystemDriverTest

com.google.k2crypto.storage.driver.optional.SqliteDriverTest

com.google.k2crypto.storage.InstalledDriver

com.google.k2crypto.storage.InstalledDriverTest

All source code are property of their respective owners. Java is a trademark of Sun Microsystems, Inc and owned by ORACLE Inc. Contact coftware#gmail.com.