com.hellosign.sdk.resource

Class AbstractRequest

java.lang.Object

com.hellosign.sdk.resource.AbstractResource

com.hellosign.sdk.resource.AbstractRequest

Direct Known Subclasses:

EmbeddedRequest, SignatureRequest, TemplateDraft, TemplateSignatureRequest, UnclaimedDraft

public abstract class AbstractRequest
extends AbstractResource

Requests to HelloSign will have common fields such as a request title, subject, and message. This class centralizes those fields.

Author:

"Chris Paul ([email protected])"

Field Summary

Fields

Modifier and Type	Field and Description
static String	REQUEST_HIDE_TEXT_TAGS
static String	REQUEST_MESSAGE
static String	REQUEST_METADATA
static String	REQUEST_REDIRECT_URL
static String	REQUEST_SUBJECT
static String	REQUEST_TEST_MODE
static String	REQUEST_TITLE
static String	REQUEST_USE_TEXT_TAGS

Fields inherited from class com.hellosign.sdk.resource.AbstractResource

dataObj, warnings

Constructor Summary

Constructors

Constructor and Description
AbstractRequest()
AbstractRequest(org.json.JSONObject json, String optionalKey)

Method Summary

Methods

Modifier and Type	Method and Description
void	addDocument(Document doc) Adds a Document to the signature request.
void	addDocument(Document doc, int order) Adds a Document to the signature request at the specific order.
void	addFile(File file) Adds the file to the request.
void	addFile(File file, Integer order) Adds the file to the request in the given order.
void	addFileUrl(String url) Add a file_url to this request.
void	addMetadata(String key, String value)
void	clearDocuments() Remove all documents from this request.
List<Document>	getDocuments() Returns a reference to the list of documents for this request.
List<String>	getFileUrls() Return the current file_url list.
abstract String	getId()
String	getMessage()
Metadata	getMetadata()
String	getMetadata(String key)
boolean	getOrderMatters() A flag that determines whether order of the signers list is enforced.
protected Map<String,Serializable>	getPostFields()
String	getRedirectUrl()
String	getSubject()
String	getTitle()
boolean	hasHideTextTags()
boolean	hasMessage()
boolean	hasRedirectUrl()
boolean	hasSubject()
boolean	hasTitle()
boolean	hasUseTextTags()
Boolean	isHidingTextTags()
boolean	isTestMode()
Boolean	isUsingTextTags()
void	setDocuments(List<Document> docs) Overwrites this requests document list with the provided document list.
void	setFileUrls(List<String> fileUrls) Overwrite the current file_url list.
void	setHideTextTags(boolean hideTextTags)
void	setMessage(String message)
void	setOrderMatters(boolean b) Determines whether the order of the signers list is to be enforced.
void	setRedirectUrl(String url)
void	setSubject(String subject)
void	setTestMode(boolean testMode)
void	setTitle(String title)
void	setUseTextTags(boolean useTextTags)

Methods inherited from class com.hellosign.sdk.resource.AbstractResource

add, addToList, clearList, get, getBoolean, getConstructor, getDate, getInteger, getJSONObject, getList, getList, getLong, getString, getWarnings, has, hasString, set, toString

Methods inherited from class java.lang.Object

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

Field Detail

REQUEST_TITLE

public static final String REQUEST_TITLE

See Also:

Constant Field Values

REQUEST_SUBJECT

public static final String REQUEST_SUBJECT

See Also:

Constant Field Values

REQUEST_MESSAGE

public static final String REQUEST_MESSAGE

See Also:

Constant Field Values

REQUEST_REDIRECT_URL

public static final String REQUEST_REDIRECT_URL

See Also:

Constant Field Values

REQUEST_TEST_MODE

public static final String REQUEST_TEST_MODE

See Also:

Constant Field Values

REQUEST_USE_TEXT_TAGS

public static final String REQUEST_USE_TEXT_TAGS

See Also:

Constant Field Values

REQUEST_HIDE_TEXT_TAGS

public static final String REQUEST_HIDE_TEXT_TAGS

See Also:

Constant Field Values

REQUEST_METADATA

public static final String REQUEST_METADATA

See Also:

Constant Field Values

Constructor Detail

AbstractRequest

public AbstractRequest()

AbstractRequest

public AbstractRequest(org.json.JSONObject json,
               String optionalKey)
                throws HelloSignException

Throws:

HelloSignException

Method Detail

getPostFields

protected Map<String,Serializable> getPostFields()
                                          throws HelloSignException

Throws:

HelloSignException

getId

public abstract String getId()

getTitle

public String getTitle()

setTitle

public void setTitle(String title)

hasTitle

public boolean hasTitle()

getSubject

public String getSubject()

setSubject

public void setSubject(String subject)

hasSubject

public boolean hasSubject()

getMessage

public String getMessage()

setMessage

public void setMessage(String message)

hasMessage

public boolean hasMessage()

setTestMode

public void setTestMode(boolean testMode)

isTestMode

public boolean isTestMode()

getRedirectUrl

public String getRedirectUrl()

setRedirectUrl

public void setRedirectUrl(String url)

hasRedirectUrl

public boolean hasRedirectUrl()

hasUseTextTags

public boolean hasUseTextTags()

isUsingTextTags

public Boolean isUsingTextTags()

setUseTextTags

public void setUseTextTags(boolean useTextTags)

hasHideTextTags

public boolean hasHideTextTags()

isHidingTextTags

public Boolean isHidingTextTags()

setHideTextTags

public void setHideTextTags(boolean hideTextTags)

getMetadata

public Metadata getMetadata()

addMetadata

public void addMetadata(String key,
               String value)

getMetadata

public String getMetadata(String key)

addFile

public void addFile(File file)
             throws HelloSignException

Adds the file to the request.

Parameters:

file - File

Throws:

HelloSignException

addFile

public void addFile(File file,
           Integer order)
             throws HelloSignException

Adds the file to the request in the given order. The order should be a 0-based index into the file list. Therefore, the first item of the file list is 0, and so forth. If order is null, the document is appended to the end of the file list.

Parameters:

file - File

order - Integer or null

Throws:

HelloSignException

addDocument

public void addDocument(Document doc)
                 throws HelloSignException

Adds a Document to the signature request.

Parameters:

doc -

Throws:

HelloSignException

addDocument

public void addDocument(Document doc,
               int order)
                 throws HelloSignException

Adds a Document to the signature request at the specific order.

Parameters:

doc -

order -

Throws:

HelloSignException

getDocuments

public List<Document> getDocuments()

Returns a reference to the list of documents for this request. Modifying this list will modify the list that will be sent with the request. Useful for more fine-grained modification.

Returns:

List

setDocuments

public void setDocuments(List<Document> docs)

Overwrites this requests document list with the provided document list.

Parameters:

docs - List

clearDocuments

public void clearDocuments()

Remove all documents from this request.

setOrderMatters

public void setOrderMatters(boolean b)

Determines whether the order of the signers list is to be enforced.

Parameters:

b - true if the order matters, false otherwise

getOrderMatters

public boolean getOrderMatters()

A flag that determines whether order of the signers list is enforced.

Returns:

true if the order matters, false otherwise

addFileUrl

public void addFileUrl(String url)

Add a file_url to this request.

Parameters:

url - String

getFileUrls

public List<String> getFileUrls()

Return the current file_url list.

Returns:

List

setFileUrls

public void setFileUrls(List<String> fileUrls)

Overwrite the current file_url list.

Parameters:

fileUrls - List