org.apache.logging.log4j.message.StructuredDataId Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of virtdata-lib-curves4 Show documentation
Show all versions of virtdata-lib-curves4 Show documentation
Statistical sampling library for use in virtdata libraries, based
on apache commons math 4
/*
* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed with
* this work for additional information regarding copyright ownership.
* The ASF licenses this file to You 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 org.apache.logging.log4j.message;
import java.io.Serializable;
import org.apache.logging.log4j.util.StringBuilderFormattable;
import org.apache.logging.log4j.util.Strings;
/**
* The StructuredData identifier.
*/
public class StructuredDataId implements Serializable, StringBuilderFormattable {
/**
* RFC 5424 Time Quality.
*/
public static final StructuredDataId TIME_QUALITY = new StructuredDataId("timeQuality", null, new String[] {
"tzKnown", "isSynced", "syncAccuracy"});
/**
* RFC 5424 Origin.
*/
public static final StructuredDataId ORIGIN = new StructuredDataId("origin", null, new String[] {"ip",
"enterpriseId", "software", "swVersion"});
/**
* RFC 5424 Meta.
*/
public static final StructuredDataId META = new StructuredDataId("meta", null, new String[] {"sequenceId",
"sysUpTime", "language"});
/**
* Reserved enterprise number.
*/
public static final int RESERVED = -1;
private static final long serialVersionUID = 9031746276396249990L;
private static final int MAX_LENGTH = 32;
private static final String AT_SIGN = "@";
private final String name;
private final int enterpriseNumber;
private final String[] required;
private final String[] optional;
/**
* Creates a StructuredDataId based on the name.
* @param name The Structured Data Element name (maximum length is 32)
* @since 2.9
*/
public StructuredDataId(final String name) {
this(name, null, null, MAX_LENGTH);
}
/**
* Creates a StructuredDataId based on the name.
* @param name The Structured Data Element name.
* @param maxLength The maximum length of the name.
* @since 2.9
*/
public StructuredDataId(final String name, final int maxLength) {
this(name, null, null, maxLength);
}
/**
*
* @param name
* @param required
* @param optional
*/
public StructuredDataId(final String name, final String[] required, final String[] optional) {
this(name, required, optional, MAX_LENGTH);
}
/**
* A Constructor that helps conformance to RFC 5424.
*
* @param name The name portion of the id.
* @param required The list of keys that are required for this id.
* @param optional The list of keys that are optional for this id.
* @since 2.9
*/
public StructuredDataId(final String name, final String[] required, final String[] optional, int maxLength) {
int index = -1;
if (name != null) {
if (maxLength <= 0) {
maxLength = MAX_LENGTH;
}
if (name.length() > maxLength) {
throw new IllegalArgumentException(String.format("Length of id %s exceeds maximum of %d characters",
name, maxLength));
}
index = name.indexOf(AT_SIGN);
}
if (index > 0) {
this.name = name.substring(0, index);
this.enterpriseNumber = Integer.parseInt(name.substring(index + 1));
} else {
this.name = name;
this.enterpriseNumber = RESERVED;
}
this.required = required;
this.optional = optional;
}
/**
* A Constructor that helps conformance to RFC 5424.
*
* @param name The name portion of the id.
* @param enterpriseNumber The enterprise number.
* @param required The list of keys that are required for this id.
* @param optional The list of keys that are optional for this id.
*/
public StructuredDataId(final String name, final int enterpriseNumber, final String[] required,
final String[] optional) {
this(name, enterpriseNumber, required, optional, MAX_LENGTH);
}
/**
* A Constructor that helps conformance to RFC 5424.
*
* @param name The name portion of the id.
* @param enterpriseNumber The enterprise number.
* @param required The list of keys that are required for this id.
* @param optional The list of keys that are optional for this id.
* @param maxLength The maximum length of the StructuredData Id key.
* @since 2.9
*/
public StructuredDataId(final String name, final int enterpriseNumber, final String[] required,
final String[] optional, final int maxLength) {
if (name == null) {
throw new IllegalArgumentException("No structured id name was supplied");
}
if (name.contains(AT_SIGN)) {
throw new IllegalArgumentException("Structured id name cannot contain an " + Strings.quote(AT_SIGN));
}
if (enterpriseNumber <= 0) {
throw new IllegalArgumentException("No enterprise number was supplied");
}
this.name = name;
this.enterpriseNumber = enterpriseNumber;
final String id = name + AT_SIGN + enterpriseNumber;
if (maxLength > 0 && id.length() > maxLength) {
throw new IllegalArgumentException("Length of id exceeds maximum of " + maxLength + " characters: " + id);
}
this.required = required;
this.optional = optional;
}
/**
* Creates an id using another id to supply default values.
*
* @param id The original StructuredDataId.
* @return the new StructuredDataId.
*/
public StructuredDataId makeId(final StructuredDataId id) {
if (id == null) {
return this;
}
return makeId(id.getName(), id.getEnterpriseNumber());
}
/**
* Creates an id based on the current id.
*
* @param defaultId The default id to use if this StructuredDataId doesn't have a name.
* @param anEnterpriseNumber The enterprise number.
* @return a StructuredDataId.
*/
public StructuredDataId makeId(final String defaultId, final int anEnterpriseNumber) {
String id;
String[] req;
String[] opt;
if (anEnterpriseNumber <= 0) {
return this;
}
if (this.name != null) {
id = this.name;
req = this.required;
opt = this.optional;
} else {
id = defaultId;
req = null;
opt = null;
}
return new StructuredDataId(id, anEnterpriseNumber, req, opt);
}
/**
* Returns a list of required keys.
*
* @return a List of required keys or null if none have been provided.
*/
public String[] getRequired() {
return required;
}
/**
* Returns a list of optional keys.
*
* @return a List of optional keys or null if none have been provided.
*/
public String[] getOptional() {
return optional;
}
/**
* Returns the StructuredDataId name.
*
* @return the StructuredDataId name.
*/
public String getName() {
return name;
}
/**
* Returns the enterprise number.
*
* @return the enterprise number.
*/
public int getEnterpriseNumber() {
return enterpriseNumber;
}
/**
* Indicates if the id is reserved.
*
* @return true if the id uses the reserved enterprise number, false otherwise.
*/
public boolean isReserved() {
return enterpriseNumber <= 0;
}
@Override
public String toString() {
final StringBuilder sb = new StringBuilder(name.length() + 10);
formatTo(sb);
return sb.toString();
}
@Override
public void formatTo(final StringBuilder buffer) {
if (isReserved()) {
buffer.append(name);
} else {
buffer.append(name).append(AT_SIGN).append(enterpriseNumber);
}
}
}