{"_id":"58c29eae76bdd119001e8267","user":"57601a13af3e090e00108059","parentDoc":null,"version":{"_id":"575aeffae12cf20e002f306f","project":"575aeffae12cf20e002f306c","__v":30,"createdAt":"2016-06-10T16:51:06.080Z","releaseDate":"2016-06-10T16:51:06.080Z","categories":["575aeffae12cf20e002f3070","575af039a083950e004487f7","575af5c7ba4ed70e000ca288","57602fe5b82256240055c657","57602ff6c811102000cef302","576030909b1a9a220067ca40","57604518b82256240055c722","5761a63d207db7170022fc14","5761b9a2b65324200072d79e","576832939f0bf4190014ffdf","576832c09f0bf4190014ffe1","576832cba151c10e004316f0","576832d5bb15f40e00a288ec","576832e107b1f30e0039c645","577680bf3cee3a0e00a000bc","577ff3b1ff48990e000c6806","5783f78c5cbce30e0074e2b7","5783f86292edb92200e6101c","5783f86dbfbba719003f0d8b","5783f8755cbce30e0074e2b8","5783f8b65cbce30e0074e2b9","5783f8bf5cbce30e0074e2ba","5783f8d8ce802f0e0087d574","578529f887c9280e0090394b","57852aeb87c9280e0090394d","57866e72b2f4060e00fa39ca","57ab6d5c39c2fd1900191879","57f39451ab0ee12000bef915","582499a0d90fa027009b259e","58c29df1258e5a1900b60478"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"2016","version_clean":"1.0.0","version":"1"},"project":"575aeffae12cf20e002f306c","__v":0,"category":{"_id":"58c29df1258e5a1900b60478","project":"575aeffae12cf20e002f306c","version":"575aeffae12cf20e002f306f","__v":0,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2017-03-10T12:37:05.075Z","from_sync":false,"order":2,"slug":"instalação-da-api-sdks","title":"Instalação da API (SDK's)"},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2017-03-10T12:40:14.266Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":5,"body":"[block:html]\n{\n  \"html\": \"<p>Nossa API é <a href=\\\"https://en.wikipedia.org/wiki/Representational_state_transfer\\\" target=\\\"_blank\\\" title=\\\"Link Externo\\\">RESTful</a> e responde em <a href=\\\"http://www.json.org/\\\" target=\\\"_blank\\\" title=\\\"Link Externo\\\">JSON</a>. A Gerencianet utiliza <a href=\\\"http://oauth.net/\\\" target=\\\"_blank\\\" title=\\\"Link Externo\\\">OAuth</a> para fornecer acesso autorizado à <abbr title=\\\"Application Programming Interface\\\">API</abbr>. Nossa SDK de Java já está preparada para realizar essa autenticação automaticamente.</p>\"\n}\n[/block]\n# Pré Requisitos\n\n- Java >= 7.0\n\n# Testado com\n\n- Java <code>7.0</code> e <code>8.0</code>\n\n# Instalando via gradle\n\n<pre>compile 'br.com.gerencianet.gnsdk:gn-api-sdk-java:0.2.2'</pre>\n\n# Instalando via maven\n\n<pre><dependency>\n    <groupId>br.com.gerencianet.gnsdk</groupId>\n    <artifactId>gn-api-sdk-java</artifactId>\n    <version>0.2.2</version>\n</dependency></pre>\n\n# Começando\n\nRequer o módulo e os pacotes:\n\n<pre>import br.com.gerencianet.gnsdk.Gerencianet;\nimport br.com.gerencianet.gnsdk.exceptions.GerencianetException;</pre>\n\nEmbora as respostas dos serviços da Web estejam no formato json, a SDK converterá qualquer resposta do servidor para um *JSONObject* ou um *Map <String, Object>*. O código deve estar dentro de um *try-catch* e as exceções podem ser tratadas da seguinte forma:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"```java\\ntry {\\n  /* code */\\n} catch(GerencianetException e) {\\n  /* Gerencianet's api errors will come here */\\n} catch(Exception ex) {\\n  /* Other errors will come here */\\n}\",\n      \"language\": \"java\"\n    }\n  ]\n}\n[/block]\n## Para ambiente de desenvolvimento\n\nInstanciar o módulo passando seu *Client_Id*, *Client_Secret* e *sandbox* sendo igual a <code>true</code>:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"JSONObject options = new JSONObject();\\noptions.put(\\\"client_id\\\", \\\"client_id\\\");\\noptions.put(\\\"client_secret\\\", \\\"client_secret\\\");\\noptions.put(\\\"sandbox\\\", true);\\n\\nGerencianet gn = new Gerencianet($options);\",\n      \"language\": \"java\",\n      \"name\": \"JSONObject\"\n    }\n  ]\n}\n[/block]\nOu então:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"Map<String, Object> options = new HashMap<String, Object>();\\noptions.put(\\\"client_id\\\", \\\"client_id\\\");\\noptions.put(\\\"client_secret\\\", \\\"client_secret\\\");\\noptions.put(\\\"sandbox\\\", true);\\n\\nGerencianet gn = new Gerencianet($options);\",\n      \"language\": \"java\",\n      \"name\": \"Map\"\n    }\n  ]\n}\n[/block]\n## Para ambiente de produção\n\nPara alterar o ambiente para produção, basta definir o terceiro sandbox como <code>false</code>, e seu *Client_Id* e *Client_Secret* de produção:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"JSONObject options = new JSONObject();\\noptions.put(\\\"client_id\\\", \\\"client_id\\\");\\noptions.put(\\\"client_secret\\\", \\\"client_secret\\\");\\noptions.put(\\\"sandbox\\\", false);\\n\\nGerencianet gn = new Gerencianet($options);\",\n      \"language\": \"java\",\n      \"name\": \"JSONObject\"\n    }\n  ]\n}\n[/block]\nOu então:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"Map<String, Object> options = new HashMap<String, Object>();\\noptions.put(\\\"client_id\\\", \\\"client_id\\\");\\noptions.put(\\\"client_secret\\\", \\\"client_secret\\\");\\noptions.put(\\\"sandbox\\\", false);\\n\\nGerencianet gn = new Gerencianet($options);\",\n      \"language\": \"java\",\n      \"name\": \"Map\"\n    }\n  ]\n}\n[/block]\n# Executando testes\n\nPara executar o conjunto de testes com *coverage:*\n\n<pre>mvn clean test jacoco:report</pre>\n\n# Executando exemplos\n\nPara executar alguns exemplos existentes siga as etapas descritas em nosso Github (<a href=\"https://github.com/gerencianet/gn-api-sdk-java-examples\" target=\"_blank\">gn-api-sdk-java-examples</a>).","excerpt":"Você está em: *\"Instalação da API (SDK's) > Java\"*","slug":"instalacao-sdk-java","type":"basic","title":"Java"}

Java

Você está em: *"Instalação da API (SDK's) > Java"*

[block:html] { "html": "<p>Nossa API é <a href=\"https://en.wikipedia.org/wiki/Representational_state_transfer\" target=\"_blank\" title=\"Link Externo\">RESTful</a> e responde em <a href=\"http://www.json.org/\" target=\"_blank\" title=\"Link Externo\">JSON</a>. A Gerencianet utiliza <a href=\"http://oauth.net/\" target=\"_blank\" title=\"Link Externo\">OAuth</a> para fornecer acesso autorizado à <abbr title=\"Application Programming Interface\">API</abbr>. Nossa SDK de Java já está preparada para realizar essa autenticação automaticamente.</p>" } [/block] # Pré Requisitos - Java >= 7.0 # Testado com - Java <code>7.0</code> e <code>8.0</code> # Instalando via gradle <pre>compile 'br.com.gerencianet.gnsdk:gn-api-sdk-java:0.2.2'</pre> # Instalando via maven <pre><dependency> <groupId>br.com.gerencianet.gnsdk</groupId> <artifactId>gn-api-sdk-java</artifactId> <version>0.2.2</version> </dependency></pre> # Começando Requer o módulo e os pacotes: <pre>import br.com.gerencianet.gnsdk.Gerencianet; import br.com.gerencianet.gnsdk.exceptions.GerencianetException;</pre> Embora as respostas dos serviços da Web estejam no formato json, a SDK converterá qualquer resposta do servidor para um *JSONObject* ou um *Map <String, Object>*. O código deve estar dentro de um *try-catch* e as exceções podem ser tratadas da seguinte forma: [block:code] { "codes": [ { "code": "```java\ntry {\n /* code */\n} catch(GerencianetException e) {\n /* Gerencianet's api errors will come here */\n} catch(Exception ex) {\n /* Other errors will come here */\n}", "language": "java" } ] } [/block] ## Para ambiente de desenvolvimento Instanciar o módulo passando seu *Client_Id*, *Client_Secret* e *sandbox* sendo igual a <code>true</code>: [block:code] { "codes": [ { "code": "JSONObject options = new JSONObject();\noptions.put(\"client_id\", \"client_id\");\noptions.put(\"client_secret\", \"client_secret\");\noptions.put(\"sandbox\", true);\n\nGerencianet gn = new Gerencianet($options);", "language": "java", "name": "JSONObject" } ] } [/block] Ou então: [block:code] { "codes": [ { "code": "Map<String, Object> options = new HashMap<String, Object>();\noptions.put(\"client_id\", \"client_id\");\noptions.put(\"client_secret\", \"client_secret\");\noptions.put(\"sandbox\", true);\n\nGerencianet gn = new Gerencianet($options);", "language": "java", "name": "Map" } ] } [/block] ## Para ambiente de produção Para alterar o ambiente para produção, basta definir o terceiro sandbox como <code>false</code>, e seu *Client_Id* e *Client_Secret* de produção: [block:code] { "codes": [ { "code": "JSONObject options = new JSONObject();\noptions.put(\"client_id\", \"client_id\");\noptions.put(\"client_secret\", \"client_secret\");\noptions.put(\"sandbox\", false);\n\nGerencianet gn = new Gerencianet($options);", "language": "java", "name": "JSONObject" } ] } [/block] Ou então: [block:code] { "codes": [ { "code": "Map<String, Object> options = new HashMap<String, Object>();\noptions.put(\"client_id\", \"client_id\");\noptions.put(\"client_secret\", \"client_secret\");\noptions.put(\"sandbox\", false);\n\nGerencianet gn = new Gerencianet($options);", "language": "java", "name": "Map" } ] } [/block] # Executando testes Para executar o conjunto de testes com *coverage:* <pre>mvn clean test jacoco:report</pre> # Executando exemplos Para executar alguns exemplos existentes siga as etapas descritas em nosso Github (<a href="https://github.com/gerencianet/gn-api-sdk-java-examples" target="_blank">gn-api-sdk-java-examples</a>).