/*
* 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
* 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
* trunk/opends/resource/legal-notices/OpenDS.LICENSE. 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 2008 Sun Microsystems, Inc.
*/
/**
* This class defines a data structure that may be used as a sort key.
* It includes an attribute type and a boolean value that indicates
* whether the sort should be ascending or descending. It may also
* contain a specific ordering matching rule that should be used for
* the sorting process, although if none is provided it will use the
* default ordering matching rule for the attribute type.
*/
mayInstantiate=true,
mayExtend=false,
mayInvoke=true)
public final class SortKey
{
/**
* The tracer object for the debug logger.
*/
// The attribute type for this sort key.
// The indication of whether the sort should be ascending.
private boolean ascending;
// The ordering matching rule to use with this sort key.
/**
* Creates a new sort key with the provided information.
*
* @param attributeType The attribute type for this sort key.
* @param ascending Indicates whether the sort should be in
* ascending order rather than descending.
*/
{
this.attributeType = attributeType;
orderingRule = null;
}
/**
* Creates a new sort key with the provided information.
*
* @param attributeType The attribute type for this sort key.
* @param ascending Indicates whether the sort should be in
* ascending order rather than descending.
* @param orderingRule The ordering matching rule to use with
* this sort key.
*/
{
this.attributeType = attributeType;
this.orderingRule = orderingRule;
}
/**
* Retrieves the attribute type for this sort key.
*
* @return The attribute type for this sort key.
*/
{
return attributeType;
}
/**
* Indicates whether the specified attribute should be sorted in
* ascending order.
*
* @return {@code true} if the attribute should be sorted in
* ascending order, or {@code false} if it should be sorted
* in descending order.
*/
public boolean ascending()
{
return ascending;
}
/**
* Retrieves the ordering matching rule to use with this sort key.
*
* @return The ordering matching rule to use with this sort key.
*/
{
return orderingRule;
}
/**
* Compares the provided values using this sort key.
*
* @param value1 The first value to be compared.
* @param value2 The second value to be compared.
*
* @return A negative value if the first value should come before
* the second in a sorted list, a positive value if the
* first value should come after the second in a sorted
* list, or zero if there is no relative difference between
* the values.
*/
{
// A null value will always come after a non-null value.
{
{
return 0;
}
else
{
return 1;
}
}
{
return -1;
}
// Use the ordering matching rule if one is provided. Otherwise,
// fall back on the default ordering rule for the attribute type.
if (orderingRule == null)
{
try
{
{
return 0;
}
if (ascending)
{
}
else
{
}
}
catch (Exception e)
{
if (debugEnabled())
{
}
return 0;
}
}
else
{
try
{
if (ascending)
{
return orderingRule.compareValues(
}
else
{
return orderingRule.compareValues(
}
}
catch (Exception e)
{
if (debugEnabled())
{
}
return 0;
}
}
}
/**
* Retrieves a string representation of this sort key.
*
* @return A string representation of this sort key.
*/
{
}
/**
* Appends a string representation of this sort key to the
* provided buffer.
*
* @param buffer The buffer to which the information should be
* appended.
*/
{
if (ascending)
{
}
else
{
}
if (orderingRule != null)
{
}
}
/**
* Retrieves the hash code for this sort key.
*
* @return The hash code for this sort key.
*/
public int hashCode()
{
int hashCode = 0;
if(ascending)
{
hashCode += 1;
}
if(orderingRule != null)
{
}
return hashCode;
}
/**
* Indicates whether this sort key is equal to the provided
* object.
*
* @param o The object for which to make the determination.
*
* @return <CODE>true</CODE> if the provide object is equal to this
* sort key, or <CODE>false</CODE> if it is not.
*/
{
if(o == null)
{
return false;
}
if (o == this)
{
return true;
}
if (! (o instanceof SortKey))
{
return false;
}
{
return false;
}
{
return false;
}
if(orderingRule != null)
{
if(s.orderingRule != null)
{
{
return false;
}
}
else if(!orderingRule.equals(
{
return false;
}
}
else if(s.orderingRule != null)
{
s.orderingRule))
{
return false;
}
}
return true;
}
}