ExitRecord.java revision e77b06d21580f630e0a7c437495ab283d3672828
/*
* CDDL HEADER START
*
* The contents of this file are subject to the terms of the
* Common Development and Distribution License (the "License").
* You may not use this file except in compliance with the License.
*
* You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
* 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 usr/src/OPENSOLARIS.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. All rights reserved.
* Use is subject to license terms.
*
* ident "%Z%%M% %I% %E% SMI"
*/
/**
* A record indicating that the DTrace {@code exit()} action is about to
* stop the source {@link Consumer}. The exit status is whatever value
* was passed to the {@code exit()} action in the D program.
* <p>
* Immutable. Supports persistence using {@link java.beans.XMLEncoder}.
*
* @author Tom Erickson
*/
static final long serialVersionUID = -2062716683135961493L;
static {
try {
new String[] {"status"})
{
/*
* Need to prevent DefaultPersistenceDelegate from using
* overridden equals() method, resulting in a
* StackOverFlowError. Revert to PersistenceDelegate
* implementation. See
* 477019&tstart=135
*/
protected boolean
{
}
};
} catch (IntrospectionException e) {
}
}
/** @serial */
private final int status;
/**
* Creates an exit record with the given status.
*
* @param exitStatus value passed to the D {@code exit()} action
*/
public
ExitRecord(int exitStatus)
{
status = exitStatus;
}
/**
* Gets the exit status of a DTrace {@link Consumer}.
*
* @return the value passed to the D {@code exit()} action
*/
public int
{
return status;
}
/**
* Compares the specified object with this {@code ExitRecord} for
* equality. Returns {@code true} if and only if the specified
* object is also an {@code ExitRecord} and both records have the
* same status.
*
* @return {@code true} if and only if the specified object is also
* an {@code ExitRecord} and both records have the same status
*/
public boolean
{
if (o instanceof ExitRecord) {
ExitRecord r = (ExitRecord)o;
}
return false;
}
/**
* Overridden to ensure that equal instances have equal hash codes.
*/
public int
hashCode()
{
return status;
}
/**
* Gets a string representation of the exit status.
*
* @return the string form of {@link #getStatus()} returned by
* {@link Integer#toString(int i)}
*/
public String
toString()
{
}
}