/target

/intellij

---------------------------------------------

1.6 (2013-07-07)

- Completely rewritten SDK, focused on web apps (no Android support).

- Many API calls not yet implemented.

- Not backwards compatible with previous versions.

Copyright (c) 2013 Dropbox Inc., http://www.dropbox.com/

Permission is hereby granted, free of charge, to any person obtaining

a copy of this software and associated documentation files (the

"Software"), to deal in the Software without restriction, including

without limitation the rights to use, copy, modify, merge, publish,

distribute, sublicense, and/or sell copies of the Software, and to

permit persons to whom the Software is furnished to do so, subject to

the following conditions:

The above copyright notice and this permission notice shall be

included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,

EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF

MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND

NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE

LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION

OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION

WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

A Java library to access [Dropbox's HTTP-based Core API](https://www.dropbox.com/developers/core/docs).

License: [MIT](License.txt)

This is for web applications. If you want to use Dropbox's API from Android, try the [Sync SDK](https://www.dropbox.com/developers/sync)

[Javadoc.](http://dropbox.github.io/dropbox-sdk-java/api-docs/v1.6.x/)

If you're using Maven, then edit your project's "pom.xml" and add this to the `<dependencies>` section:

<dependency>

<groupId>com.dropbox.core</groupId>

<artifactId>dropbox-core-sdk</artifactId>

<version>[1.6,1.7)</version>

</dependency>

If you aren't using Maven, here are the JARs you need:

- [Dropbox Core SDK](http://repo1.maven.org/maven2/com/dropbox/core/dropbox-core-sdk/1.6-beta-1/dropbox-core-sdk-1.6-beta-1.jar)

- [Jackson Core](http://repo1.maven.org/maven2/com/fasterxml/jackson/core/jackson-core/2.2.2/jackson-core-2.2.2.jar) (JSON parser)

You need a Dropbox API key to make API requests.

* Go to: [https://www.dropbox.com/developers/apps](https://www.dropbox.com/developers/apps)

* If you've already registered an app, click on the "Options" link to see the app's API key and secret.

* Otherwise, click "Create an app" to register an app. Choose "Full Dropbox" or "App Folder" [depending on your needs](https://www.dropbox.com/developers/reference#permissions).

Save the API key to a JSON file called, say, "test.app":

Before your app can access a Dropbox user's files, the user must authorize your application using OAuth 2. Successfully completing this authorization flow gives you an _access token_ for the user's Dropbox account, which grants you the ability to make Dropbox API calls to access their files.

* Authorization example for a simple web app: [Web File Browser example](examples/web-file-browser/src/com/dropbox/core/examples/web_file_browser/DropboxAuth.java)

* Authorization example for a command-line tool: [Command-Line Authorization example](examples/authorize/src/com/dropbox/core/examples/authorize/Main.java)

Once you have an access token, create a [`DbxClient`](http://dropbox.github.io/dropbox-sdk-java/api-docs/v1.6.x/com/dropbox/core/DbxClient.html) and start making API calls.

You only need to perform the authorization process once per user. Once you have an access token for a user, save it somewhere persistent, like in a database. The next time that user visits your app's, you can skip the authorization process and go straight to creating a `DbxClient` and making API calls.

Prerequisites: Apache Maven

1. Download this repository.

2. Save your Dropbox API key in a file called "test.app". See: [Get a Dropbox API key](#get-a-dropbox-api-key), above.

3. `mvn install`

4. `mvn -f examples/pom.xml compile`

This examples runs through the OAuth 2 authorization flow.

This produces a file named "test.auth" that has the access token. This file can be passed in to the other examples.

A trivial example that calls the /account/info API endpoint.

(You must first generate "test.auth" using the "authorize" example above.)

A tiny web app that runs through the OAuth 2 authorization flow and then uses Dropbox API calls to let the user browse their Dropbox files.

Prerequisite: In the Dropbox API [app configuration console](https://www.dropbox.com/developers/apps), you need to add "http://localhost:5000/dropbox-auth-finish" to the list of allowed redirect URIs.

/*.app

/*.auth

/web-file-browser.db

/target

<project xmlns="http://maven.apache.org/POM/4.0.0"

xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

xsi:schemaLocation="http://maven.apache.org/POM/4.0.0

http://maven.apache.org/maven-v4_0_0.xsd">

<modelVersion>4.0.0</modelVersion>

<name>Account Info Example (Dropbox Core API SDK)</name>

<artifactId>examples-account-info</artifactId>

<packaging>jar</packaging>

<parent>

<groupId>com.dropbox.core</groupId>

<artifactId>examples</artifactId>

<version>0-SNAPSHOT</version>

<relativePath>../pom.xml</relativePath>

</parent>

<build>

<plugins>

<plugin>

<groupId>org.apache.maven.plugins</groupId>

<artifactId>maven-dependency-plugin</artifactId>

<executions>

<execution>

<phase>compile</phase>

<goals>

<goal>build-classpath</goal>

</goals>

</execution>

</executions>

</plugin>

</plugins>

</build>

</project>

package com.dropbox.core.examples.account_info;

import com.dropbox.core.*;

import com.dropbox.core.json.JsonReader;

import java.io.IOException;

import java.util.Locale;

import java.util.logging.Level;

import java.util.logging.Logger;

public class Main

{

public static void main(String[] args)

throws IOException

{

// Only display important log messages.

Logger.getLogger("").setLevel(Level.WARNING);

if (args.length == 0) {

System.out.println("");

System.out.println("Usage: COMMAND <auth-file>");

System.out.println("");

System.out.println(" <auth-file>: An \"auth file\" that contains the information necessary to make");

System.out.println(" an authorized Dropbox API request. Generate this file using the \"authorize\"");

System.out.println(" example program.");

System.out.println("");

return;

}

if (args.length != 1) {

System.err.println("Expecting exactly 1 argument, got " + args.length + ".");

System.err.println("Run with no arguments for help.");

System.exit(1); return;

}

String argAuthFile = args[0];

// Read auth info file.

DbxAuthInfo authInfo;

try {

authInfo = DbxAuthInfo.Reader.readFromFile(argAuthFile);

}

catch (JsonReader.FileLoadException ex) {

System.err.println("Error loading <auth-file>: " + ex.getMessage());

System.exit(1); return;

}

// Create a DbxClient, which is what you use to make API calls.

String userLocale = Locale.getDefault().toString();

DbxRequestConfig requestConfig = new DbxRequestConfig("examples-account-info", userLocale);

DbxClient dbxClient = new DbxClient(requestConfig, authInfo.accessToken, authInfo.host);

// Make the /account/info API call.

DbxAccountInfo dbxAccountInfo;

try {

dbxAccountInfo = dbxClient.getAccountInfo();

}

catch (DbxException ex) {

ex.printStackTrace();

System.err.println("Error in getAccountInfo(): " + ex.getMessage());

System.exit(1); return;

}

System.out.println("User's account info: " + dbxAccountInfo.toStringMultiline());

}

}

/target