/* * CDDL HEADER START * * The contents of this file are subject to the terms of the * Common Development and Distribution License, Version 1.0 only * (the "License"). You may not use this file except in compliance * with the License. * * You can obtain a copy of the license at legal-notices/CDDLv1_0.txt * or http://forgerock.org/license/CDDLv1.0.html. * See the License for the specific language governing permissions * and limitations under the License. * * When distributing Covered Code, include this CDDL HEADER in each * file and include the License file at legal-notices/CDDLv1_0.txt. * If applicable, add the following below this CDDL HEADER, with the * fields enclosed by brackets "[]" replaced with your own identifying * information: * Portions Copyright [yyyy] [name of copyright owner] * * CDDL HEADER END * * * Copyright 2006-2008 Sun Microsystems, Inc. * Portions Copyright 2014 ForgeRock AS */ package org.opends.server.schema; import java.util.Collection; import java.util.Collections; import org.forgerock.i18n.slf4j.LocalizedLogger; import org.forgerock.opendj.ldap.ByteSequence; import org.forgerock.opendj.ldap.ByteString; import org.forgerock.opendj.ldap.DecodeException; import org.opends.server.api.EqualityMatchingRule; import org.opends.server.core.DirectoryServer; import org.opends.server.types.DirectoryException; import static org.opends.server.schema.SchemaConstants.*; /** * This class defines the generalizedTimeMatch matching rule defined in X.520 * and referenced in RFC 2252. */ class GeneralizedTimeEqualityMatchingRule extends EqualityMatchingRule { private static final LocalizedLogger logger = LocalizedLogger.getLoggerForThisClass(); /** * Creates a new instance of this generalizedTimeMatch matching rule. */ public GeneralizedTimeEqualityMatchingRule() { super(); } /** * {@inheritDoc} */ @Override public Collection getNames() { return Collections.singleton(EMR_GENERALIZED_TIME_NAME); } /** * Retrieves the OID for this matching rule. * * @return The OID for this matching rule. */ @Override public String getOID() { return EMR_GENERALIZED_TIME_OID; } /** * Retrieves the description for this matching rule. * * @return The description for this matching rule, or null if * there is none. */ @Override public String getDescription() { // There is no standard description for this matching rule. return null; } /** * Retrieves the OID of the syntax with which this matching rule is * associated. * * @return The OID of the syntax with which this matching rule is associated. */ @Override public String getSyntaxOID() { return SYNTAX_GENERALIZED_TIME_OID; } /** * Retrieves the normalized form of the provided value, which is best suited * for efficiently performing matching operations on that value. * * @param value The value to be normalized. * * @return The normalized version of the provided value. * * @throws DecodeException If the provided value is invalid according to * the associated attribute syntax. */ @Override public ByteString normalizeAttributeValue(ByteSequence value) throws DecodeException { try { long timestamp = GeneralizedTimeSyntax.decodeGeneralizedTimeValue(value); return ByteString.valueOf(GeneralizedTimeSyntax.format(timestamp)); } catch (DirectoryException de) { logger.traceException(de); switch (DirectoryServer.getSyntaxEnforcementPolicy()) { case REJECT: throw DecodeException.error(de.getMessageObject(), de); case WARN: logger.error(de.getMessageObject()); break; } return value.toByteString(); } } /** * Indicates whether the two provided normalized values are equal to each * other. * * @param value1 The normalized form of the first value to compare. * @param value2 The normalized form of the second value to compare. * * @return true if the provided values are equal, or * false if not. */ @Override public boolean areEqual(ByteSequence value1, ByteSequence value2) { try { long time1 = GeneralizedTimeSyntax.decodeGeneralizedTimeValue(value1); long time2 = GeneralizedTimeSyntax.decodeGeneralizedTimeValue(value2); return (time1 == time2); } catch (DirectoryException de) { logger.traceException(de); return false; } } }