VolumeChooser (Apache Accumulo Server Base 2.0.1 API)

All Known Implementing Classes:

PerTableVolumeChooser, PreferredVolumeChooser, RandomVolumeChooser, SpaceAwareVolumeChooser
```
public interface VolumeChooser
```
Helper used by VolumeManagers to select from a set of Volume URIs. N.B. implementations must be threadsafe. VolumeChooser.equals will be used for internal caching.
Implementations may wish to store configuration in Accumulo's system configuration using the Property.GENERAL_ARBITRARY_PROP_PREFIX. They may also benefit from using per-table configuration using Property.TABLE_ARBITRARY_PROP_PREFIX.

Nested Class Summary

Nested Classes
Modifier and Type Interface Description

static class VolumeChooser.VolumeChooserException

Method Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method	Description
`String`	`choose(VolumeChooserEnvironment env, String[] options)`	Choose a volume from the provided options.

- Method Detail
  - choose
```
String choose(VolumeChooserEnvironment env,
              String[] options)
       throws VolumeChooser.VolumeChooserException
```
    Choose a volume from the provided options.
    
    Parameters:
    
    env - the server environment provided by the calling framework
    
    options - the list of volumes to choose from
    
    Returns:
    
    one of the options
    
    Throws:
    
    VolumeChooser.VolumeChooserException - if there is an error choosing (this is a RuntimeException); this does not preclude other RuntimeExceptions from occurring