JarCastingMicrosoft Graph Auth Preview SDK for Java
Get started with the Microsoft Graph SDK for Java by integrating the Microsoft Graph API into your Java application!
Important Note about the Microsoft Graph Auth Preview SDK for Java
During the preview we may make changes to the API, and other mechanisms of this library, which you will be required to take along with bug fixes or feature improvements. This may impact your application. An API change may require you to update your code. When we provide the General Availability release we will require you to update to the General Availability version within six months, as applications written using a preview version of library may no longer work.
1. Installation
1.1 Install via Gradle
Add the repository and a compile dependency for microsoft-graph-auth to your project's build.gradle:
repository {
maven { url 'https://oss.sonatype.org/content/repositories/snapshots' }
}
dependency {
// Include the sdk as a dependency
compile('com.microsoft.graph:microsoft-graph-auth:0.3.0-SNAPSHOT')
}
1.2 Install via Maven
Add the dependency in dependencies in pom.xml
<dependency>
<groupId>com.microsoft.graph</groupId>
<artifactId>microsoft-graph-auth</artifactId>
<version>0.3.0-SNAPSHOT</version>
</dependency>
Add in project
<profiles>
<profile>
<id>allow-snapshots</id>
<activation><activeByDefault>true</activeByDefault></activation>
<repositories>
<repository>
<id>snapshots-repo</id>
<url>https://oss.sonatype.org/content/repositories/snapshots</url>
<releases><enabled>false</enabled></releases>
<snapshots><enabled>true</enabled></snapshots>
</repository>
</repositories>
</profile>
</profiles>
2. Getting started
2.1 Register your application
Register your application by following the steps at Register your app with the Azure AD v2.0 endpoint.
2.2 Create an authentication provider object
2.3.1 Confidential client authentication provider
a. Authorization code provider
AuthorizationCodeProvider authProvider = new AuthorizationCodeProvider(CLIENT_ID, SCOPES, AUTHORIZATION_CODE, REDIRECT_URL, NATIONAL_CLOUD, TENANT, CLIENT_SECRET);
b. Client credential provider
ClientCredentialProvider authProvider = new ClientCredentialProvider(CLIENT_ID, SCOPES, CLIENT_SECRET, TENANT_GUID, NATIONAL_CLOUD);
2.3.2 Public client authentication provider
a. Username password provider
UsernamePasswordProvider authProvider = new UsernamePasswordProvider(CLIENT_ID, SCOPES, USERNAME, PASSWORD, NATIONAL_CLOUD, TENANT, CLIENT_SECRET);
2.3 Get a HttpClient object and make a call
Using msgraph-sdk-java
IGraphServiceClient graphClient = GraphServiceClient
.builder()
.authenticationProvider(authProvider)
.buildClient();
User user = graphClient.me().buildRequest().get();
Using msgraph-sdk-java-core
OkHttpClient client = HttpClients.createDefault(authProvider);
Request request = new Request.Builder().url("https://graph.microsoft.com/v1.0/me").build();
Response response = client.newCall(request).execute();
System.out.println(response.body().string());
3. Make requests against the service
After you have a GraphServiceClient that is authenticated, you can begin making calls against the service. The requests against the service look like our REST API.
3.1 Get the user's drive
To retrieve the user's drive:
Using msgraph-sdk-java
IGraphServiceClient graphClient =
GraphServiceClient
.builder()
.authenticationProvider(authProvider)
.buildClient();
Drive drive = graphClient.me().drive().buildRequest().get();
Using msgraph-sdk-java-core
OkHttpClient httpclient = HttpClients.createDefault(authenticationProvider);
Request request = new Request.Builder().url("https://graph.microsoft.com/v1.0/me/drive").build();
Response response = client.newCall(request).execute();
System.out.println( respose.body().string() );
4. Sample
4.1 Authorization code provider
Steps to get authorizationCode
AuthorizationCodeProvider authProvider = new AuthorizationCodeProvider("6731de76-14a6-49ae-97bc-6eba6914391e",
Arrays.asList("https://graph.microsoft.com/user.read","https://graph.microsoft.com/Mail.ReadWrite"),
authorizationCode,
"http://localhost/myapp/",
NationalCloud.Global,
"common",
"JqQX2PNo9bpM0uEihUPzyrh");
IGraphServiceClient graphClient =
GraphServiceClient
.builder()
.authenticationProvider(authProvider)
.buildClient();
IMessageCollectionPage page = graphClient.me().messages().buildRequest().get();
while(page != null) {
for(Message message : page.getCurrentPage()) {
System.out.println(message.subject);
}
IMessageCollectionRequestBuilder builder = page.getNextPage();
if(builder == null)break;
page = builder.buildRequest().get();
}
5. Documentation
For more detailed documentation, see:
6. Issues
For known issues, see issues.
7. Contributions
The Microsoft Graph SDK is open for contribution. To contribute to this project, see Contributing.
Thanks to everyone who has already devoted time to improving the library:
 Nakul Sabharwal |
 Deepak Agrawal |
|---|
This project follows the all-contributors specification. Contributions of any kind are welcome!
8. Supported Java versions
The Microsoft Graph SDK for Java library is supported at runtime for Java 7+ and Android API revision 15 and greater.
9. License
Copyright (c) Microsoft Corporation. All Rights Reserved. Licensed under the MIT license.
