com.emc.ecs.nfsclient.nfs

Class NfsCreateRequest

java.lang.Object

com.emc.ecs.nfsclient.rpc.RpcRequest

com.emc.ecs.nfsclient.nfs.NfsRequestBase

com.emc.ecs.nfsclient.nfs.NfsCreateRequest

All Implemented Interfaces:

NfsRequest

Direct Known Subclasses:

Nfs3CreateRequest

public class NfsCreateRequest
extends NfsRequestBase

The request, as specified by RFC 1813 (https://tools.ietf.org/html/rfc1813).

Procedure CREATE creates a regular file.

Field Summary

Fields inherited from class com.emc.ecs.nfsclient.rpc.RpcRequest

CHARSET

Constructor Summary

Constructors

Constructor and Description
NfsCreateRequest(NfsCreateMode createMode, byte[] parentDirectoryFileHandle, java.lang.String name, NfsSetAttributes attributes, byte[] verifier, Credential credential, int nfsVersion) Creates the request, as specified by RFC 1813 (https://tools.ietf.org/html/rfc1813).

Method Summary

Modifier and Type	Method and Description
byte[]	getVerifier()
void	marshalling(Xdr xdr) Transfer data to an Xdr object for RPC use.
java.lang.String	toString()

Methods inherited from class com.emc.ecs.nfsclient.nfs.NfsRequestBase

getErrorMessage, getFileHandle, getIpKey, startToString

Methods inherited from class com.emc.ecs.nfsclient.rpc.RpcRequest

cloneFileHandle, isUsePrivilegedPort, setUsePrivilegedPort, trimFileName

Methods inherited from class java.lang.Object

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

Constructor Detail

NfsCreateRequest

public NfsCreateRequest(NfsCreateMode createMode,
                        byte[] parentDirectoryFileHandle,
                        java.lang.String name,
                        NfsSetAttributes attributes,
                        byte[] verifier,
                        Credential credential,
                        int nfsVersion)
                 throws java.io.FileNotFoundException

Creates the request, as specified by RFC 1813 (https://tools.ietf.org/html/rfc1813).

Procedure CREATE creates a regular file.

Parameters:

createMode - The instance describing how the file is to be created. UNCHECKED means that the file should be created without checking for the existence of a duplicate file in the same directory. In this case, how.obj_attributes is a sattr3 describing the initial attributes for the file. GUARDED specifies that the server should check for the presence of a duplicate file before performing the create and should fail the request with NFS3ERR_EXIST if a duplicate file exists. If the file does not exist, the request is performed as described for UNCHECKED. EXCLUSIVE specifies that the server is to follow exclusive creation semantics, using the verifier to ensure exclusive creation of the target. No attributes may be provided in this case, since the server may use the target file metadata to store the createverf3 verifier.

parentDirectoryFileHandle - The file handle for the directory in which the file is to be created.

name - The name that is to be associated with the created file.

attributes - The initial attributes for the new file.

verifier - A unique identifier to ensure exclusive creation of the new file. If no value is provided for exclusive creation, this is generated.

credential - The credential used for RPC authentication.

nfsVersion - The NFS version number

Throws:

java.io.FileNotFoundException

Method Detail

marshalling

public void marshalling(Xdr xdr)

Description copied from interface: NfsRequest

Transfer data to an Xdr object for RPC use. The format is specified by RFC 1813 (https://tools.ietf.org/html/rfc1813).

Specified by:

marshalling in interface NfsRequest

Overrides:

marshalling in class NfsRequestBase

Parameters:

xdr - the Xdr to be sent.

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

getVerifier

public byte[] getVerifier()

Returns:

A unique identifier to ensure exclusive creation of the new file. If no value was provided for exclusive creation, this was generated.