com.authlete.common.dto.TokenCreateResponse Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of authlete-java-common Show documentation
Show all versions of authlete-java-common Show documentation
Authlete Java library used commonly by service implementations and the Authlete server.
/*
* Copyright (C) 2015-2016 Authlete, Inc.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package com.authlete.common.dto;
import com.authlete.common.types.GrantType;
import com.authlete.common.util.Utils;
/**
* Response from Authlete's {@code /auth/token/create} API.
*
*
* Authlete's {@code /auth/token/create} API returns JSON which can
* be mapped to this class. The first step that a caller should take is
* to retrieve the value of {@code action} parameter from the response.
* The list below shows possible values of {@code action} parameter and
* their meanings.
*
*
*
*
* - {@link Action#INTERNAL_SERVER_ERROR INTERNAL_SERVER_ERROR}
* -
*
* When the value of {@code action} parameter is {@code "INTERNAL_SERVER_ERROR"},
* it means that an error occurred on Authlete side.
*
*
*
* - {@link Action#BAD_REQUEST BAD_REQUEST}
* -
*
* When the value of {@code action} parameter is {@code "BAD_REQUEST"},
* it means that the request from the caller was wrong. For example,
* this happens when the {@code grantType} request parameter is not
* specified.
*
*
*
* - {@link Action#FORBIDDEN FORBIDDEN}
* -
*
* When the value of {@code action} parameter is {@code "FORBIDDEN"},
* it means that the request from the caller is not allowed. For example,
* this happens when the client application identified by the {@code
* clientId} request parameter does not belong to the service identified
* by the API key used for the API call.
*
*
*
* - {@link Action#OK OK}
* -
*
* When the value of {@code action} parameter is {@code "OK"}, it means
* that everything was processed successfully and an access token and
* optionally a refresh token were issued.
*
*
*
*
*
*
* So, in short, when the value of {@code action} parameter in the response
* from Authlete's {@code /auth/token/create} API is {@code "OK"}, you can
* find a new access token and optionally a new refresh token in {@code
* accessToken} parameter and {@code refreshToken} parameter.
*
*
* @author Takahiko Kawasaki
*
* @since 1.13
*/
public class TokenCreateResponse extends ApiResponse
{
/**
* The code indicating how the response should be interpreted.
*/
public enum Action
{
/**
* An error occurred on Authlete side.
*/
INTERNAL_SERVER_ERROR,
/**
* The request from the caller was wrong. For example, this
* happens when the {@code grantType} request parameter was
* missing.
*/
BAD_REQUEST,
/**
* The request from the caller was not allowed. For example,
* this happens when the client application identified by the
* {@code clientId} request parameter does not belong to the
* service identified by the API key used for the API call.
*/
FORBIDDEN,
/**
* An access token and optionally a refresh token were issued
* successfully.
*/
OK
}
private static final long serialVersionUID = 3L;
private static final String SUMMARY_FORMAT
= "action=%s, grantType=%s, clientId=%d, subject=%s, scopes=%s, "
+ "accessToken=%s, tokenType=%s, expiresIn=%d, expiresAt=%d, refreshToken=%s";
private Action action;
private GrantType grantType;
private long clientId;
private String subject;
private String[] scopes;
private String accessToken;
private String tokenType;
private long expiresIn;
private long expiresAt;
private String refreshToken;
private Property[] properties;
/**
* Get the code indicating how the response should be interpreted.
* See the {@link TokenCreateResponse description} of this class
* for details.
*
* @return
* The code indicating how the response should be interpreted.
*/
public Action getAction()
{
return action;
}
/**
* Set the code indicating how the response should be interpreted.
* See the {@link TokenCreateResponse description} of this class
* for details.
*
* @param action
* The code indicating how the response should be interpreted.
*
* @return
* {@code this} object.
*/
public TokenCreateResponse setAction(Action action)
{
this.action = action;
return this;
}
/**
* Get the {@link GrantType grant type} for the newly issued
* access token.
*
* @return
* Grant type.
*/
public GrantType getGrantType()
{
return grantType;
}
/**
* Set the {@link GrantType grant type} for the newly issued
* access token.
*
* @param grantType
* Grant type.
*
* @return
* {@code this} object.
*/
public TokenCreateResponse setGrantType(GrantType grantType)
{
this.grantType = grantType;
return this;
}
/**
* Get the client ID associated with the newly issued access token.
*
* @return
* Client ID.
*/
public long getClientId()
{
return clientId;
}
/**
* Set the client ID associated with the newly issued access token.
*
* @param clientId
* Client ID.
*
* @return
* {@code this} object.
*/
public TokenCreateResponse setClientId(long clientId)
{
this.clientId = clientId;
return this;
}
/**
* Get the subject (= unique identifier) of the user associated
* with the newly issued access token. This value is {@code null}
* when the {@link GrantType grant type} obtained by {@link
* #getGrantType()} is {@link GrantType#CLIENT_CREDENTIALS
* CLIENT_CREDENTIALS}.
*
* @return
* The subject of the user.
*/
public String getSubject()
{
return subject;
}
/**
* Set the subject (= unique identifier) of the user associated
* with the newly issued access token.
*
* @param subject
* The subject of the user.
*
* @return
* {@code this} object.
*/
public TokenCreateResponse setSubject(String subject)
{
this.subject = subject;
return this;
}
/**
* Get the scopes associated with the newly issued access token.
*
* @return
* Scopes. May be {@code null}.
*/
public String[] getScopes()
{
return scopes;
}
/**
* Set the scopes associated with the newly issued access token.
*
* @param scopes
* Scopes.
*
* @return
* {@code this} object.
*/
public TokenCreateResponse setScopes(String[] scopes)
{
this.scopes = scopes;
return this;
}
/**
* Get the newly issued access token.
*
* @return
* Access token.
*/
public String getAccessToken()
{
return accessToken;
}
/**
* Set the newly issued access token.
*
* @param accessToken
* Access token.
*
* @return
* {@code this} object.
*/
public TokenCreateResponse setAccessToken(String accessToken)
{
this.accessToken = accessToken;
return this;
}
/**
* Get the token type of the access token. For example, {@code "Bearer"}.
*
* @return
* Token type.
*/
public String getTokenType()
{
return tokenType;
}
/**
* Set the token type of the access token. For example, {@code "Bearer"}.
*
* @param tokenType
* Token type.
*
* @return
* {@code this} object.
*/
public TokenCreateResponse setTokenType(String tokenType)
{
this.tokenType = tokenType;
return this;
}
/**
* Get the duration of the newly issued access token in seconds.
*
* @return
* The duration of the access token.
*/
public long getExpiresIn()
{
return expiresIn;
}
/**
* Set the duration of the newly issued access token in seconds.
*
* @param expiresIn
* The duration of the access token.
*
* @return
* {@code this} object.
*/
public TokenCreateResponse setExpiresIn(long expiresIn)
{
this.expiresIn = expiresIn;
return this;
}
/**
* Get the date at which the newly issued access token will expire.
* The value is expressed in milliseconds since Unix epoch (1970-01-01).
*
* @return
* The date at which the newly issued access token will expire.
*/
public long getExpiresAt()
{
return expiresAt;
}
/**
* Set the date at which the newly issued access token will expire.
*
* @param expiresAt
* The date at which the newly issued access token will expire.
* The value is required to be expressed in milliseconds since
* Unix epoch (1970-01-01).
*
* @return
* {@code this} object.
*/
public TokenCreateResponse setExpiresAt(long expiresAt)
{
this.expiresAt = expiresAt;
return this;
}
/**
* Get the newly issued refresh token.
*
* @return
* Refresh token. This is {@code null} when the grant type is
* either {@link GrantType#IMPLICIT IMPLICIT} or {@link
* GrantType#CLIENT_CREDENTIALS CLIENT_CREDENTIALS}.
*/
public String getRefreshToken()
{
return refreshToken;
}
/**
* Set the newly issued refresh token.
*
* @param refreshToken
* Refresh token.
*
* @return
* {@code this} object.
*/
public TokenCreateResponse setRefreshToken(String refreshToken)
{
this.refreshToken = refreshToken;
return this;
}
/**
* Get the properties associated with the access token.
*
* @return
* Properties.
*
* @since 1.34
*/
public Property[] getProperties()
{
return properties;
}
/**
* Set the properties associated with the access token.
*
* @param properties
* Properties.
*
* @return
* {@code this} object.
*
* @since 1.34
*/
public TokenCreateResponse setProperties(Property[] properties)
{
this.properties = properties;
return this;
}
/**
* Get the summary of this instance.
*/
public String summarize()
{
return String.format(SUMMARY_FORMAT,
action, grantType, clientId, subject, Utils.join(scopes, " "),
accessToken, tokenType, expiresIn, expiresAt, refreshToken);
}
}
© 2015 - 2025 Weber Informatics LLC | Privacy Policy