org.jclouds.openstack.cinder.v1.predicates
Class VolumePredicates

java.lang.Object
  org.jclouds.openstack.cinder.v1.predicates.VolumePredicates

public class VolumePredicates
extends Object

Tests to see if volume has reached status. This class is most useful when paired with a RetryablePredicate as in the code below. This class can be used to block execution until the Volume status has reached a desired state. This is useful when your Volume needs to be 100% ready before you can continue with execution.

 Volume volume = volumeApi.create(100);
 
 RetryablePredicate<String> awaitAvailable = RetryablePredicate.create(
    VolumePredicates.available(volumeApi), 600, 10, 10, TimeUnit.SECONDS);
 
 if (!awaitAvailable.apply(volume.getId())) {
    throw new TimeoutException("Timeout on volume: " + volume); 
 }    
 
 

You can also use the static convenience methods as so.

 Volume volume = volumeApi.create(100);
 
 if (!VolumePredicates.awaitAvailable(volumeApi).apply(volume.getId())) {
    throw new TimeoutException("Timeout on volume: " + volume);     
 }
 
 

Constructor Summary

VolumePredicates()

Method Summary

static com.google.common.base.Predicate<Volume>	awaitAvailable(VolumeApi volumeApi) Wait until a Volume is Available.
static com.google.common.base.Predicate<Volume>	awaitDeleted(VolumeApi volumeApi) Wait until a Volume no longer exists.
static com.google.common.base.Predicate<Volume>	awaitInUse(VolumeApi volumeApi) Wait until a Volume is In Use.
static com.google.common.base.Predicate<Volume>	awaitStatus(VolumeApi volumeApi, Volume.Status status, long maxWaitInSec, long periodInSec)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

VolumePredicates

public VolumePredicates()

Method Detail

awaitAvailable

public static com.google.common.base.Predicate<Volume> awaitAvailable(VolumeApi volumeApi)

Wait until a Volume is Available.

Parameters:

volumeApi - The VolumeApi in the zone where your Volume resides.

Returns:

RetryablePredicate That will check the status every 5 seconds for a maxiumum of 10 minutes.

awaitInUse

public static com.google.common.base.Predicate<Volume> awaitInUse(VolumeApi volumeApi)

Wait until a Volume is In Use.

Parameters:

volumeApi - The VolumeApi in the zone where your Volume resides.

Returns:

RetryablePredicate That will check the status every 5 seconds for a maxiumum of 10 minutes.

awaitDeleted

public static com.google.common.base.Predicate<Volume> awaitDeleted(VolumeApi volumeApi)

Wait until a Volume no longer exists.

Parameters:

volumeApi - The VolumeApi in the zone where your Volume resides.

Returns:

RetryablePredicate That will check the whether the Volume exists every 5 seconds for a maxiumum of 10 minutes.

awaitStatus

public static com.google.common.base.Predicate<Volume> awaitStatus(VolumeApi volumeApi,
                                                                   Volume.Status status,
                                                                   long maxWaitInSec,
                                                                   long periodInSec)