/*
 * @(#)file      SnmpTableEntryNotification.java
 * @(#)author    Sun Microsystems, Inc.
 * @(#)version   4.14
 * @(#)date      05/04/13
 *
 * Copyright 2004 Sun Microsystems, Inc. All rights reserved.
 * SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms.
 *
 */


package com.sun.jmx.snmp.agent;



// jmx imports
//
import javax.management.Notification;
import javax.management.ObjectName;

/**
 * Represents a notification emitted when an
 * entry is added or deleted from an SNMP table.
 * <P>
 * The <CODE>SnmpTableEntryNotification</CODE> object contains 
 * the reference to the entry added or removed from the table.
 * <P>
 * The list of notifications fired by the <CODE>SnmpMibTable</CODE> is 
 * the following:
 * <UL>
 * <LI>A new entry has been added to the SNMP table.
 * <LI>An existing entry has been removed from the SNMP table.
  </UL>
 * 
 * <p><b>This API is a Sun Microsystems internal API  and is subject 
 * to change without notice.</b></p>
 * @version     4.14     12/19/03
 * @author      Sun Microsystems, Inc
 */

public class SnmpTableEntryNotification extends Notification {
  
    /**
     * Creates and initializes a table entry notification object.
     *
     * @param type The notification type.
     * @param source The notification producer.
     * @param sequenceNumber The notification sequence number within the 
     *                  source object.
     * @param timeStamp The notification emission date.
     * @param entry     The entry object (may be null if the entry is 
     *                  registered in the MBeanServer).
     * @param entryName The ObjectName entry object (may be null if the
     *                  entry is not registered in the MBeanServer).
     * @since 1.5
     */
    SnmpTableEntryNotification(String type, Object source, 
			       long sequenceNumber, long timeStamp, 
			       Object entry, ObjectName entryName) {
        
        super(type, source, sequenceNumber, timeStamp);
        this.entry = entry;
	this.name  = entryName;
    }
    
    /**
     * Gets the entry object.
     * May be null if the entry is registered in the MBeanServer, and the
     * MIB is using the generic MetaData (see mibgen).
     *
     * @return The entry.
     */
    public Object getEntry() {
        return entry;
    }
  
    /**
     * Gets the ObjectName of the entry.
     * May be null if the entry is not registered in the MBeanServer.
     *
     * @return The ObjectName of the entry.
     * @since 1.5
     */
    public ObjectName getEntryName() {
        return name;
    }
  
    // PUBLIC VARIABLES
    //-----------------
    
    /**
     * Notification type denoting that a new entry has been added to the 
     * SNMP table.
     * <BR>The value of this notification type is 
     * <CODE>jmx.snmp.table.entry.added</CODE>.
     */
    public static final String SNMP_ENTRY_ADDED = 
	new String("jmx.snmp.table.entry.added");

    /**
     * Notification type denoting that an entry has been removed from the 
     * SNMP table.
     * <BR>The value of this notification type is 
     * <CODE>jmx.snmp.table.entry.removed</CODE>.
     */
    public static final String SNMP_ENTRY_REMOVED = 
	new String("jmx.snmp.table.entry.removed");
    
    // PRIVATE VARIABLES
    //------------------
  
    /**
     * The entry object.
     * @serial
     */
    private final Object entry;  

    /**
     * The entry name.
     * @serial
     * @since 1.5
     */
    private final ObjectName name;  

    // Ensure compatibility 
    //
    private static final long serialVersionUID = 5832592016227890252L;
}
