docusign-code-examples/java/JavaSDKSamples.java at master · DSDevCenter/docusign-code-examples

491 lines (396 loc) · 18.7 KB
package docusign_tests;
import com.docusign.esign.api.*;
import com.docusign.esign.client.*;
import com.docusign.esign.model.*;
import com.docusign.esign.client.auth.AccessTokenListener;
import org.apache.oltu.oauth2.common.exception.OAuthSystemException;
import org.apache.oltu.oauth2.common.token.BasicOAuthToken;
import java.awt.Desktop;
import java.io.File;
import java.io.IOException;
import java.io.UnsupportedEncodingException;
import java.net.URI;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
import java.util.List;
import java.util.ArrayList;
import java.util.Base64;
public class JavaSDKSamples {
	///////////////////////////////////////////////////////////////////////////
	public static void main(String[] args) throws IOException, ApiException {
		// integrator keys are created through developer sandbox accounts then migrated
		// to your production account when ready. Note that your integrator key also acts
		// as your client ID during oauth requests
		String IntegratorKey = "{CLIENT_ID}";
		// generate a client secret for the integrator key you supply above, again through sandbox admin menu
		String ClientSecret = "{CLIENT_SECRET}";
		// must match a redirect URI (case-sensitive) you configured on the key
		String RedirectURI = "{REDIRECT_URI}";
		// use demo authentication server (remove -d for production)
		String AuthServerUrl = "https://account-d.docusign.com";
		// point to the demo (sandbox) environment. For production requests your account sub-domain 
		// will vary, you should always use the base URI that is returned from authentication to
		// ensure your integration points to the correct endpoints (in both environments)
		String RestApiUrl = "https://demo.docusign.net/restapi";
		// instantiate the api client and configure auth server
		ApiClient apiClient = new ApiClient(AuthServerUrl, "docusignAccessCode", IntegratorKey, ClientSecret);
		// set the base path for REST API requests
		apiClient.setBasePath(RestApiUrl);
		// configure the authorization flow on the api client
		apiClient.configureAuthorizationFlow(IntegratorKey, ClientSecret, RedirectURI);
		// set as default api client in your configuration
		Configuration.setDefaultApiClient(apiClient);
		///////////////////////////////////////////////////////////////////////////
		// RUN SAMPLES
		///////////////////////////////////////////////////////////////////////////
		JavaSDKSamples test = new JavaSDKSamples();
		// First request an Authorization Code 
		test.getAuthCode(apiClient);
		// Once you get an auth code copy into getAuthToken() function and run a sample
//		String accountId = test.getAuthToken(apiClient);
		// Create envelope with embedded recipient 
//		test.createEnvelopeWithEmbeddedRecipient(apiClient, accountId);		
		// Embedded Recipient View (ie signing URL)
//		test.createRecipientView(apiClient, accountId, envelopeId);		
		// Create envelope
//		test.createEnvelope(apiClient, accountId);		
		// Create envelope from a template
//		test.createEnvelopeFromTemplate(apiClient, accountId);
		// List and download envelope Documents
//		EnvelopeDocumentsResult docs = test.listEnvelopeDocuments(accountId, envelopeId);
//		test.downloadEnvelopeDocuments(accountId, envelopeId, docs);
		// List envelope recipients
//		test.listRecipients(accountId, envelopeId);
		// Get envelope status and info
//		test.getEnvelope(accountId, envelopeId);
		// List status for multiple envelopes
//		test.listMultipleEnvelopeStatuses(accountId);
		// Embedded Sender View (ie the "tag and send" view) 
//		test.embeddedSenderView(accountId, envelopeId);
		// Embedded Console View (ie the DocuSign WebApp)
//		test.embeddedConsoleView(accountId);		
	///////////////////////////////////////////////////////////////////////////
	public void getAuthCode(ApiClient apiClient) throws IOException 
			// get DocuSign OAuth authorization url
			String oauthLoginUrl = apiClient.getAuthorizationUri();
			// open DocuSign OAuth login in the browser
			System.out.println(oauthLoginUrl);
			Desktop.getDesktop().browse(URI.create(oauthLoginUrl));
		catch (OAuthSystemException ex)
			System.out.println("Exception: " + ex);
	///////////////////////////////////////////////////////////////////////////
	public String getAuthToken(ApiClient apiClient) 
		// IMPORTANT: after the login, DocuSign will send back a fresh authorization code as a query param
		// of the redirect URI. You should set up a route that handles the redirect call to get that code
		// and pass it to token endpoint as shown in the next lines:
		String code = "[YOUR_AUTHORIZATION_CODE_GOES_HERE]";
		// assign it to the token endpoint
		apiClient.getTokenEndPoint().setCode(code);
		// optionally register to get notified when a new token arrives
		apiClient.registerAccessTokenListener(new AccessTokenListener() {
			@Override
			public void notify(BasicOAuthToken token) {
				System.out.println("Got a fresh token: " + token.getAccessToken());
		// following call exchanges the authorization code for an access code and updates 
		// the `Authorization: bearer <token>` header on the api client
		apiClient.updateAccessToken();
		// retrieve the base uri for core API service requests
		System.out.println("Getting base_uri...");
		return getBaseUri(apiClient);
	///////////////////////////////////////////////////////////////////////////
	public String getBaseUri(ApiClient apiClient)
			AuthenticationApi authApi = new AuthenticationApi(apiClient);
			LoginInformation loginInfo = authApi.login();		
			// that note user might belong to multiple accounts, here we get first
			String accountId = loginInfo.getLoginAccounts().get(0).getAccountId(); 
			String baseUrl = loginInfo.getLoginAccounts().get(0).getBaseUrl();
			String[] accountDomain = baseUrl.split("/v2");
			// below code required for production (no effect in demo since all accounts on same domain) 
			apiClient.setBasePath(accountDomain[0]);
			Configuration.setDefaultApiClient(apiClient);
			System.out.println("Configuring api client with following base URI: " + accountDomain[0]);
			return accountId;
		catch(Exception ex) {
			System.out.println("Error: " + ex);
			return null;
	///////////////////////////////////////////////////////////////////////////
	public void createEnvelopeFromTemplate(ApiClient apiClient, String accountId) throws ApiException 
		// create a new envelope to manage the signature request
		EnvelopeDefinition envDef = new EnvelopeDefinition();
		envDef.setEmailSubject("DocuSign Java SDK - Sample Signature Request");
		// assign template information including ID and role(s)
		envDef.setTemplateId("[TEMPLATE_ID]");
		// create a template role with a valid templateId and roleName and assign signer info
		TemplateRole tRole = new TemplateRole();
		tRole.setRoleName("[ROLE]");
		tRole.setName("[RECIPIENT_NAME]");
		tRole.setEmail("[RECIPIENT_EMAIL]");
		// create a list of template roles and add our newly created role
		java.util.List<TemplateRole> templateRolesList = new java.util.ArrayList<TemplateRole>();
		templateRolesList.add(tRole);
		// assign template role(s) to the envelope 
		envDef.setTemplateRoles(templateRolesList);
		// send the envelope by setting |status| to "sent". To save as a draft set to "created"
		envDef.setStatus("sent");
		// instantiate a new EnvelopesApi object
		EnvelopesApi envelopesApi = new EnvelopesApi(apiClient);
		// call the createEnvelope() API
		EnvelopeSummary envelopeSummary = envelopesApi.createEnvelope(accountId, envDef);
		System.out.println("Envelope has been sent to " + tRole.getEmail());
	///////////////////////////////////////////////////////////////////////////
	public void createEnvelopeWithEmbeddedRecipient(ApiClient apiClient, String accountId) throws ApiException 
		// create a byte array that will hold our document bytes
		byte[] fileBytes = null;
		String pathToDocument = "[PATH/TO/DOCUMENT]";
		    String currentDir = System.getProperty("user.dir");
		    // read file from a local directory
		    Path path = Paths.get(currentDir + pathToDocument);
		    fileBytes = Files.readAllBytes(path);
		catch (IOException ioExcp)
		    // TODO: handle error
		    System.out.println("Exception: " + ioExcp);
		    return;
		// create an envelope that will store the document(s), field(s), and recipient(s)
		EnvelopeDefinition envDef = new EnvelopeDefinition();
		envDef.setEmailSubject("Please sign this document sent from Java SDK)");
		// add a document to the envelope
		Document doc = new Document();  
		String base64Doc = Base64.getEncoder().encodeToString(fileBytes);
		doc.setDocumentBase64(base64Doc);
		doc.setName("TestFile"); // can be different from actual file name
		doc.setFileExtension(".pdf");
		doc.setDocumentId("1");
		List<Document> docs = new ArrayList<Document>();
		docs.add(doc);
		envDef.setDocuments(docs);
		// add a recipient to sign the document, identified by name and email we used above
		Signer signer = new Signer();
		signer.setEmail("[RECIPIENT_EMAIL]");
		signer.setName("[RECIPIENT_NAME]");
		signer.setRecipientId("1");
		// Must set |clientUserId| to embed the recipient which in turn makes it possible to 
		// generate a signing token (link) for them. This is a client defined string value
		// which is also needed to create the recipient view URL in the next step
		signer.setClientUserId("1001");
		// create a |signHere| tab somewhere on the document for the signer to sign
		// default unit of measurement is pixels, can be mms, cms, inches also
		SignHere signHere = new SignHere();
		signHere.setDocumentId("1");
		signHere.setPageNumber("1");
		signHere.setRecipientId("1");
		signHere.setXPosition("100");
		signHere.setYPosition("150");
		// can have multiple tabs, so need to add to envelope as a single element list
		List<SignHere> signHereTabs = new ArrayList<SignHere>();      
		signHereTabs.add(signHere);
		Tabs tabs = new Tabs();
		tabs.setSignHereTabs(signHereTabs);
		signer.setTabs(tabs);
		// add recipients (in this case a single signer) to the envelope
		envDef.setRecipients(new Recipients());
		envDef.getRecipients().setSigners(new ArrayList<Signer>());
		envDef.getRecipients().getSigners().add(signer);
		// send the envelope by setting |status| to "sent". To save as a draft set to "created"
		envDef.setStatus("sent");
		    // instantiate a new EnvelopesApi object
		    EnvelopesApi envelopesApi = new EnvelopesApi();
		    // call the createEnvelope() API
		    EnvelopeSummary envelopeSummary = envelopesApi.createEnvelope(accountId, envDef);
		    System.out.println("EnvelopeSummary: " + envelopeSummary);
		catch (com.docusign.esign.client.ApiException ex)
		    System.out.println("Exception: " + ex);
	///////////////////////////////////////////////////////////////////////////
	public void createRecipientView(ApiClient apiClient, String accountId, String envelopeId) throws ApiException, IOException {
		// instantiate a new EnvelopesApi object
		EnvelopesApi envelopesApi = new EnvelopesApi();
		// set the url where you want the recipient to go once they are done signing
		RecipientViewRequest view = new RecipientViewRequest();
		view.setReturnUrl("https://www.docusign.com");
		view.setAuthenticationMethod("email");
		// recipient information must match embedded recipient info we provided in step #2
		view.setEmail("[RECIPIENT_EMAIL]");
		view.setUserName("[RECIPIENT_NAME]");
		view.setRecipientId("1");
		view.setClientUserId("1001");
		// call the CreateRecipientView API
		ViewUrl recipientView = envelopesApi.createRecipientView(accountId, envelopeId, view);
		System.out.println("Signing URL = " + recipientView.getUrl());
		Desktop.getDesktop().browse(URI.create(recipientView.getUrl()));
	///////////////////////////////////////////////////////////////////////////
	public void createEnvelope(ApiClient apiClient, String accountId) throws ApiException {
		// create a byte array that will hold our document bytes
		byte[] fileBytes = null;
		String pathToDocument = "[PATH/TO/DOCUMENT]";
		    String currentDir = System.getProperty("user.dir");
		    // read file from a local directory
		    Path path = Paths.get(currentDir + pathToDocument);
		    fileBytes = Files.readAllBytes(path);
		catch (IOException ioExcp)
		    // TODO: handle error
		    System.out.println("Exception: " + ioExcp);
		    return;
		// create an envelope that will store the document(s), field(s), and recipient(s)
		EnvelopeDefinition envDef = new EnvelopeDefinition();
		envDef.setEmailSubject("Please sign this document sent from Java SDK)");
		// add a document to the envelope
		Document doc = new Document();  
		String base64Doc = Base64.getEncoder().encodeToString(fileBytes);
		doc.setDocumentBase64(base64Doc);
		doc.setName("TestFile"); // can be different from actual file name
		doc.setFileExtension(".pdf");	// update if different extension!
		doc.setDocumentId("1");
		List<Document> docs = new ArrayList<Document>();
		docs.add(doc);
		envDef.setDocuments(docs);
		// add a recipient to sign the document, identified by name and email we used above
		Signer signer = new Signer();
		signer.setEmail("[RECIPIENT_EMAIL]");
		signer.setName("[RECIPIENT_NAME]");
		signer.setRecipientId("1");
		// create a |signHere| tab somewhere on the document for the signer to sign
		// here we arbitrarily place it 100 pixels right, 150 pixels down from top
		// left corner of first page of first envelope document
		SignHere signHere = new SignHere();
		signHere.setDocumentId("1");
		signHere.setPageNumber("1");
		signHere.setRecipientId("1");
		signHere.setXPosition("100");
		signHere.setYPosition("150");
		// can have multiple tabs, so need to add to envelope as a single element list
		List<SignHere> signHereTabs = new ArrayList<SignHere>();      
		signHereTabs.add(signHere);
		Tabs tabs = new Tabs();
		tabs.setSignHereTabs(signHereTabs);
		signer.setTabs(tabs);
		// add recipients (in this case a single signer) to the envelope
		envDef.setRecipients(new Recipients());
		envDef.getRecipients().setSigners(new ArrayList<Signer>());
		envDef.getRecipients().getSigners().add(signer);
		// send the envelope by setting |status| to "sent". To save as a draft set to "created" instead
		envDef.setStatus("sent");
		    // instantiate a new EnvelopesApi object
		    EnvelopesApi envelopesApi = new EnvelopesApi();
		    // call the createEnvelope() API
		    EnvelopeSummary envelopeSummary = envelopesApi.createEnvelope(accountId, envDef);
		    System.out.println("Envelope has been sent to " + signer.getEmail());
		    System.out.println("EnvelopeSummary: " + envelopeSummary);
		catch (com.docusign.esign.client.ApiException ex)
		    System.out.println("Exception: " + ex);
	///////////////////////////////////////////////////////////////////////////
	public void embeddedSenderView(String accountId, String envelopeId) throws ApiException {
		// instantiate a new EnvelopesApi object
		EnvelopesApi envelopesApi = new EnvelopesApi();
		// set the url where you want the sender to go once they are done editing/sending the envelope
		ReturnUrlRequest returnUrl = new ReturnUrlRequest();
		returnUrl.setReturnUrl("https://www.docusign.com/devcenter");
		// call the createEnvelope() API
		ViewUrl senderView = envelopesApi.createSenderView(accountId, envelopeId, returnUrl);
		System.out.println("SenderView URL: " + senderView.getUrl());
	///////////////////////////////////////////////////////////////////////////	
	public void embeddedConsoleView(String accountId) throws ApiException {
		// instantiate a new envelopesApi object
		EnvelopesApi envelopesApi = new EnvelopesApi();
		// set the url where you want the user to go once they logout of the Console
		ConsoleViewRequest returnUrl = new ConsoleViewRequest();
		returnUrl.setReturnUrl("https://www.docusign.com/devcenter");
		// call the createConsoleView() API
		ViewUrl consoleView = envelopesApi.createConsoleView(accountId, returnUrl);
		System.out.println("Console URL: " + consoleView.getUrl());
	///////////////////////////////////////////////////////////////////////////	
	public void listMultipleEnvelopeStatuses(String accountId) throws ApiException, UnsupportedEncodingException {
		// instantiate a new EnvelopesApi object
		EnvelopesApi envelopesApi = new EnvelopesApi();  
		// the list status changes call requires at least a from_date
		EnvelopesApi.ListStatusChangesOptions options = envelopesApi.new ListStatusChangesOptions();
		// set from date to filter envelopes (ex: Jan 15, 2018)
		String date = "2018/15/01";
		options.setFromDate(date);
		// call the listStatusChanges() API
		EnvelopesInformation envelopes = envelopesApi.listStatusChanges(accountId, options);
		System.out.println("EnvelopesInformation: " + envelopes);
	///////////////////////////////////////////////////////////////////////////	
	public void getEnvelope(String accountId, String envelopeId) throws ApiException {
		// instantiate a new EnvelopesApi object
		EnvelopesApi envelopesApi = new EnvelopesApi();
		// call the getEnvelope() API
		Envelope env = envelopesApi.getEnvelope(accountId, envelopeId);
		System.out.println("EnvelopeInfo = " + env);
	///////////////////////////////////////////////////////////////////////////	
	public void listRecipients(String accountId, String envelopeId) throws ApiException {
		// instantiate a new EnvelopesApi object
		EnvelopesApi envelopesApi = new EnvelopesApi();
		// call the listRecipients() API
		Recipients recips = envelopesApi.listRecipients(accountId, envelopeId);
		System.out.println("EnvelopeRecipients : " + recips);
	///////////////////////////////////////////////////////////////////////////	
	public EnvelopeDocumentsResult listEnvelopeDocuments(String accountId, String envelopeId) throws ApiException {
		// instantiate a new EnvelopesApi object
	    EnvelopesApi envelopesApi = new EnvelopesApi();
	    // call the listDocuments API to list info about each envelope document
	    EnvelopeDocumentsResult docsList = envelopesApi.listDocuments(accountId, envelopeId);
		System.out.println("EnvelopeDocumentsResult: " + docsList);
		return docsList;
	///////////////////////////////////////////////////////////////////////////	
	public void downloadEnvelopeDocuments(String accountId, String envelopeId, EnvelopeDocumentsResult docsList) throws ApiException, IOException {
		// instantiate a new EnvelopesApi object
	    EnvelopesApi envelopesApi = new EnvelopesApi();
		// loop through each EnvelopeDocument object
		for( EnvelopeDocument doc: docsList.getEnvelopeDocuments() ) {
			// call the getDocument() API for each document and write to current dir
			Files.write(
				new File(doc.getName()).toPath(), 
				envelopesApi.getDocument(accountId, envelopeId, doc.getDocumentId())
} // end class
Provide feedback

Saved searches

Use saved searches to filter your results more quickly

FilesExpand file tree

JavaSDKSamples.java

Latest commit

History

JavaSDKSamples.java

File metadata and controls
