Changeset 20094

Timestamp:

Oct 13, 2008, 11:20:33 AM (18 years ago)

Author:

jhoblitt

Message:

add Nebulous::Client->swap() method

Location:

trunk/Nebulous

Files:

• Changes (modified) (1 diff)
• MANIFEST (modified) (1 diff)
• lib/Nebulous/Client.pm (modified) (2 diffs)
• lib/Nebulous/Client.pod (modified) (2 diffs)
• t/67_client_swap.t (added)

trunk/Nebulous/Changes

@@ -6 +6 @@
       no instance
     - retry all calls to open()
+    - add Nebulous::Client->swap() method
 
 0.09 Wed Jul  9 16:36:27 HST 2008

trunk/Nebulous/MANIFEST

@@ -102 +102 @@
 t/65_client_mounts.t
 t/66_client_xattr.t
+t/67_client_swap.t
 t/90_nebclient.t
 t/TEST.PL

trunk/Nebulous/lib/Nebulous/Client.pm

@@ -1 +1 @@
 # Copyright (c) 2004-2008  Joshua Hoblitt
 #
-# $Id: Client.pm,v 1.61 2008-10-13 20:54:49 jhoblitt Exp $
+# $Id: Client.pm,v 1.62 2008-10-13 21:20:33 jhoblitt Exp $
 
 package Nebulous::Client;
@@ -907 +907 @@
 
 
+sub swap
+{
+    my $self = shift;
+
+    my ( $key1, $key2 ) = validate_pos( @_,
+        {
+            type => SCALAR,
+        },
+        {
+            type => SCALAR,
+        },
+    );
+
+    $log->debug( "entered - @_" );
+
+    my $response = $self->{ 'server' }->swap_objects( $key1, $key2 );
+    if ( $response->fault ) {
+        $self->set_err($response->faultstring);
+
+        if ($response->faultstring =~ /is valid object key/) {
+            $log->debug( "leaving" );
+            return;
+        }
+
+        $log->logdie("unhandled fault - ", $self->err);
+    }
+
+    $log->debug( "leaving" );
+
+    return 1;
+}
+
+
 sub delete_instance
 {

trunk/Nebulous/lib/Nebulous/Client.pod

@@ -30 +30 @@
     $neb->copy( "key", "new_key", "node01" );
     $neb->move( "key", "new_key" );
+    $neb->swap( "key1", "key2" );
     $neb->delete_instance( $uri );
     my $stats = $neb->stat( "key" );
@@ -349 +350 @@
 
 =item * new_key
+
+The destination object.
+
+=back
+
+Returns true on success or C<undef> on failure.
+
+
+=item * swap($key1, $key2)
+
+Atomically swaps the names of two storage objects.
+
+=over 4
+
+=item * key1
+
+The source object.
+
+=item * key2
 
 The destination object.