periodictableelement.java

化学图形处理软件

/*
 *  $RCSfile$
 *  $Author: egonw $
 *  $Date: 2007-01-04 18:46:10 +0100 (Thu, 04 Jan 2007) $
 *  $Revision: 7636 $
 *
 *  Copyright (C) 2005-2007  Miguel Rojasch <[e-mail]>
 *
 *  Contact: [e-mail]
 *
 *  This library is free software; you can redistribute it and/or
 *  modify it under the terms of the GNU Lesser General Public
 *  License as published by the Free Software Foundation; either
 *  version 2.1 of the License, or (at your option) any later version.
 *
 *  This library is distributed in the hope that it will be useful,
 *  but WITHOUT ANY WARRANTY; without even the implied warranty of
 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 *  Lesser General Public License for more details.
 *
 *  You should have received a copy of the GNU Lesser General Public
 *  License along with this library; if not, write to the Free Software
 *  Foundation, 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. 
 */
package org.openscience.cdk;

import org.openscience.cdk.tools.LoggingTool;

/**
 * subclass of Elements for PeriodicTable.
 *
 * @author        Miguel Rojas
 * @cdk.created   May 8, 2005
 * @cdk.keyword   element
 * @cdk.module    extra
 */
public class PeriodicTableElement extends Element
{
	
	/**
     * Determines if a de-serialized object is compatible with this class.
     *
     * This value must only be changed if and only if the new version
     * of this class is imcompatible with the old version. See Sun docs
     * for <a href=http://java.sun.com/products/jdk/1.1/docs/guide
     * /serialization/spec/version.doc.html>details</a>.
	 */
	private static final long serialVersionUID = -2508810950266128526L;

	private static LoggingTool logger;
	
	/** The name for this element. */
	protected String name;
	
	/** The chemical serie for this element. 
	*  A chemical series is a group of chemical elements whose physical and 
	*    chemical characteristics vary progressively from one end of the series 
	*    to another.
	*  Chemical series were discovered before the creation of the periodic 
	*    table of the chemical elements, which was created to try to organise 
	*    the elements according to their chemical properties. 
	*/
	protected String chemicalSerie;
	
	/** The period which this element belong. 
	*  In the periodic table of the elements, a period is a row of the table.
	*/
	protected String period;
	
	/** The group which this element belong.
	*  In the periodic table of the elements, a period is a row of the table.
	*  the elements in a same group have similar configurations of the outermost 
  	*    electron shells of their atoms
	*/
  	protected String group;
  	  
  	/** The phase which this element find.
  	*   In the physical sciences, a phase is a set of states of a macroscopic 
  	*    physical system that have relatively uniform chemical composition 
  	*    and physical properties.
  	*   Most familiar examples of phases are solids, liquids, and gases
  	*/
  	protected String phase;
   	 
   	/** 
	*   The CAS (Chemical Abstracts Service) number which this element has.
   	*/
    	protected String casId;
    
    
	/**
	 *  Constructor for the PeriodicTableElement object.
	 *
	 * @param symbol The symbol of the element
	 */
	public PeriodicTableElement(String symbol)
	{
		this.symbol = symbol;
		logger = new LoggingTool(this);
	}
	/**
	* Returns the name of this element.
	*
	* @return The name of this element. Null if unset.
	*
	* @see    #setName
	*/
	public String getName() 
	{
		return this.name;
	}

	/**
	* Sets the name of this element.
	*
	* @param name The name to be assigned to this element
	*
	* @see    #getName
	*/
	public void setName(String name) 
	{
		this.name=name;
		notifyChanged();
	}

	/**
	* Returns the chemical serie of this element.
	*
	* @return The chemical serie of this element. Null if unset.
	*
	* @see    #setChemicalSerie
	*/
	public String getChemicalSerie() 
	{
		return this.chemicalSerie;
	}

	/**
	* Sets the chemical serie of this element.
	*
	* @param chemicalSerie The chemical serie to be assigned to this element
	*
	* @see    #getChemicalSerie
	*/
	public void setChemicalSerie(String chemicalSerie) 
	{
		this.chemicalSerie = chemicalSerie;
		notifyChanged();
	}

	/**
	* Returns the period which this element belongs.
	* 
	* @return The period of this element. Null if unset.
	*
	* @see    #setPeriod
	*/
	public String getPeriod() 
	{
		return this.period;
	}
	
	/**
	* Sets the chemical serie of this element.
	*
	* @param period The period to be assigned to this element
	*
	* @see    #getPeriod
	*/
	public void setPeriod(String period) 
	{
		this.period = period;
		notifyChanged();
	}
	
	/**
	* Returns the Group which this element belongs.
	* 
	* @return The group of this element. Null if unset.
	*
	* @see    #setGroup
	*/
	public String getGroup() 
	{
		return this.group;
	}

	/**
	* Sets the group, which this element belongs.
	*
	* @param group The group to be assigned to this atom
	*
	* @see    #getGroup
	*/
	public void setGroup(String group) 
	{
		this.group = group;
		notifyChanged();
	}
	
	/**
	* Returns the phase which this element find.
	* 
	* @return The phase of this element. Null if unset.
	*
	* @see    #setPhase
	*/
	public String getPhase() 
	{
		return this.phase;
	}

	/**
	* Sets the phase, which this element finds.
	*
	* @param phase The phase to be assigned to this element
	*
	* @see    #getGroup
	* @see #getPhase
	*/
	public void setPhase(String  phase) 
	{
		this.phase = phase;
		notifyChanged();
	}
	
	/**
	* Returns the CAS (Chemical Abstracts Service), which this element has.
	* 
	* @return The CAS of this element. Null if unset.
	*
	* @see    #setCASid
	*/
	public String getCASid() 
	{
		return this.casId;
	}
	
	/**
	* Sets the CAS (Chemical Abstracts Service), which this element has.
	*
	* @param casId The CAS number to be assigned to this element
	*
	* @see    #getCASid
	*/
	public void setCASid(String  casId) 
	{
		this.casId = casId;
		notifyChanged();
	}

	/**
         * Clones this element object.
         *
         * @return  The cloned object   
         */
	 public Object clone() throws CloneNotSupportedException 
	 {
		 Object clone = null;
		 try {
			 clone = super.clone();
		 } catch (Exception exception) {
			 logger.debug(exception);
		 }
		 return clone;
	 }
	 /**
	 *  Configures an element. Finds the correct element type
	 *  by looking at the element symbol.
	 *
	 *@param  elementPT   The element of the Periodic Table to be configure
	 *@return element     The configured element
	 */
	 public static Element configure(PeriodicTableElement elementPT)
	 {
		Element element = new Element(elementPT.getSymbol());
		
		element.setSymbol(elementPT.getSymbol());
		element.setAtomicNumber(elementPT.getAtomicNumber());
		//element.setName(ElementInt.getName());
		//element.setChemicalSerie(ElementInt.getChemicalSerie());
		//element.setPeriod(ElementInt.getPeriod());
		//element.setGroup(ElementInt.getGroup());
		//element.setPhase(ElementInt.getPhase());
		//element.setCASid(ElementInt.getCASid());
		return element;
	}
    	/**
	*
	*@return resultString  String
	*/
	public String toString() 
	{
		StringBuffer resultString = new StringBuffer();
		resultString.append("PeriodicTableElement(");
		
		resultString.append(getSymbol());
		resultString.append(", AN:"); resultString.append(getAtomicNumber());
		resultString.append(", N:"); resultString.append(getName());
		resultString.append(", CS:"); resultString.append(getChemicalSerie());
		resultString.append(", P:"); resultString.append(getPeriod());
		resultString.append(", G:"); resultString.append(getGroup());
		resultString.append(", Ph:"); resultString.append(getPhase());
		resultString.append(", CAS:"); resultString.append(getCASid());
		
		resultString.append(')');
		return resultString.toString();
	}
}