com.nimbusds.jose.util.Base64URL Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of nimbus-jose-jwt Show documentation
Show all versions of nimbus-jose-jwt Show documentation
Java library for Javascript Object Signing and Encryption (JOSE) and
JSON Web Tokens (JWT)
/*
* nimbus-jose-jwt
*
* Copyright 2012-2016, Connect2id Ltd.
*
* 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.nimbusds.jose.util;
import java.math.BigInteger;
import net.jcip.annotations.Immutable;
/**
* Base64URL-encoded object.
*
* Related specifications:
*
*
* - RFC 4648.
*
*
* @author Vladimir Dzhuvinov
* @version 2019-10-04
*/
@Immutable
public class Base64URL extends Base64 {
/**
* Creates a new Base64URL-encoded object.
*
* @param base64URL The Base64URL-encoded object value. The value is
* not validated for having characters from the
* Base64URL alphabet. Must not be {@code null}.
*/
public Base64URL(final String base64URL) {
super(base64URL);
}
/**
* Overrides {@code Object.equals()}.
*
* @param object The object to compare to.
*
* @return {@code true} if the objects have the same value, otherwise
* {@code false}.
*/
@Override
public boolean equals(final Object object) {
return object instanceof Base64URL &&
this.toString().equals(object.toString());
}
/**
* Creates a new Base64URL-encoded object from the specified string.
*
* @param base64URL The Base64URL-encoded object value, {@code null} if
* not specified. The value is not validated for
* having characters from the Base64URL alphabet.
*
* @return The Base64URL-encoded object, {@code null} if not specified.
*/
public static Base64URL from(final String base64URL) {
if (base64URL == null) {
return null;
}
return new Base64URL(base64URL);
}
/**
* Base64URL-encodes the specified byte array.
*
* @param bytes The byte array to encode. Must not be {@code null}.
*
* @return The resulting Base64URL object.
*/
public static Base64URL encode(final byte[] bytes) {
return new Base64URL(Base64Codec.encodeToString(bytes, true));
}
/**
* Base64URL-encodes the specified big integer, without the sign bit.
*
* @param bigInt The big integer to encode. Must not be {@code null}.
*
* @return The resulting Base64URL object.
*/
public static Base64URL encode(final BigInteger bigInt) {
return encode(BigIntegerUtils.toBytesUnsigned(bigInt));
}
/**
* Base64URL-encodes the specified string.
*
* @param text The string to encode. Must be in the UTF-8 character set
* and not {@code null}.
*
* @return The resulting Base64URL object.
*/
public static Base64URL encode(final String text) {
return encode(text.getBytes(StandardCharset.UTF_8));
}
}
© 2015 - 2024 Weber Informatics LLC | Privacy Policy