device.java

用于串口通讯测试的工具软件。完全使用java语言编写。

/***********************************************************************
 * Module:  Device.java
 * Author:  jzx
 * Purpose: Defines the Class Device
 ***********************************************************************/

package com.zcsoft.stock;

import java.io.*;
import java.beans.*;
import javax.swing.event.*;

/** <p>Title: 立体仓库中的设备数据对象 </p>
  * <p>Description: 可动/静止设备 </p>
  * <p>Copyright: Copyright (c) 2002</p>
  * <p>Company: Zhicheng Software&Service Co. Ltd.</p>
  *
  *
  * @author 蒋智湘
  * @version 1.0 */
public abstract class Device implements Serializable
{
	/** use serialVersionUID from JDK 1.0.2 for interoperability */
	private static final long serialVersionUID = -8605125614022003001L;
	/** 设备唯一标识号 */
	private Object ID;
	/** 设备错误描述 */
	private String errorMsg;
	/** bean属性变化传递器 */
	private transient PropertyChangeSupport changeSupport;

	/** @param ID 设备唯一标识号
	  * @see #setID(Object)
	  * @see #setImage(Image) */
	public Device(Object ID)
	{
		if(ID == null)
		{
			throw new NullPointerException("ID is null");
		}
		this.ID = ID;
	}

	public Object getID()
	{
		return ID;
	}

	/** 如果两设备的ID是否相等，则相等
	  *
	  * @param an 另一个对象
	  * @return 如果相等，则为true，否则为false */
	public boolean equals(Object an)
	{
		return an != null
				 && (an instanceof Device)
				 && this.ID.equals(((Device)an).ID);
	}

	/** @return 设备ID的散列值 */
	public int hashCode()
	{
		return this.ID.hashCode();
	}

	/** @param an */
	public void copyFieldFrom(Device an)
	{
		this.setErrorMsg(an.errorMsg);
	}

	/** Adds a PropertyChangeListener to the listener list.
	  * The listener is registered for all properties.
	  *
	  *
	  * @param listener the PropertyChangeListener to be added */
	public synchronized void addPropertyChangeListener(PropertyChangeListener listener)
	{
		if (changeSupport == null)
		{
			changeSupport = new SwingPropertyChangeSupport(this);
		}
		changeSupport.addPropertyChangeListener(listener);
	}

	/** Adds a PropertyChangeListener to the listener list.
	  * The listener is registered for specified property.
	  *
	  *
	  * @param name property name
	  * @param listener the PropertyChangeListener to be added */
	public synchronized void addPropertyChangeListener(String name, PropertyChangeListener listener)
	{
		if (changeSupport == null)
		{
			changeSupport = new SwingPropertyChangeSupport(this);
		}
		changeSupport.addPropertyChangeListener(name, listener);
	}

	/** Removes a PropertyChangeListener from the listener list.
	  * This removes a PropertyChangeListener that was registered
	  * for all properties.
	  *
	  *
	  * @param listener the PropertyChangeListener to be removed */
	public synchronized void removePropertyChangeListener(PropertyChangeListener listener)
	{
		if (changeSupport != null)
		{
			changeSupport.removePropertyChangeListener(listener);
		}
	}

	/** Removes a PropertyChangeListener from the listener list.
	  * This removes a PropertyChangeListener that was registered
	  * for specified property.
	  *
	  *
	  * @param name property name
	  * @param listener the PropertyChangeListener to be removed */
	public synchronized void removePropertyChangeListener(String name, PropertyChangeListener listener)
	{
		if (changeSupport != null)
		{
			changeSupport.removePropertyChangeListener(name, listener);
		}
	}

	/** 通知属性发生变化
	  *
	  * @param propertyName 属性名称
	  * @param oldValue 变化前的值
	  * @param newValue 变化后的值 */
	protected void firePropertyChange(String propertyName, Object oldValue, Object newValue)
	{
		if (changeSupport != null && oldValue != newValue)
		{
			changeSupport.firePropertyChange(propertyName, oldValue, newValue);
		}
	}

	/** 通知属性发生变化
	  *
	  * @param propertyName 属性名称
	  * @param oldValue 变化前的值
	  * @param newValue 变化后的值 */
	protected void firePropertyChange(String propertyName, boolean oldValue, boolean newValue)
	{
		if (changeSupport != null && oldValue != newValue)
		{
			changeSupport.firePropertyChange(propertyName, oldValue, newValue);
		}
	}

	/** 通知属性发生变化
	  *
	  * @param propertyName 属性名称
	  * @param oldValue 变化前的值
	  * @param newValue 变化后的值 */
	protected void firePropertyChange(String propertyName, int oldValue, int newValue)
	{
		if (changeSupport != null && oldValue != newValue)
		{
			changeSupport.firePropertyChange(propertyName, oldValue, newValue);
		}
	}


	public void setErrorMsg(String msg)
	{
		String old = this.errorMsg;
		this.errorMsg = msg;
		this.firePropertyChange("errorMsg", old, msg);
	}


	public String getErrorMsg()
	{
		return errorMsg;
	}

}