src/net/pterodactylus/jsite/core/Node.java

   1 /*
   2  * jSite2 - Node.java -
   3  * Copyright © 2008 David Roden
   4  *
   5  * This program is free software; you can redistribute it and/or modify
   6  * it under the terms of the GNU General Public License as published by
   7  * the Free Software Foundation; either version 2 of the License, or
   8  * (at your option) any later version.
   9  *
  10  * This program is distributed in the hope that it will be useful,
  11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  13  * GNU General Public License for more details.
  14  *
  15  * You should have received a copy of the GNU General Public License
  16  * along with this program; if not, write to the Free Software
  17  * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
  18  */
  19
  20 package net.pterodactylus.jsite.core;
  21
  22 import java.beans.PropertyChangeListener;
  23
  24 import net.pterodactylus.jsite.util.IdGenerator;
  25 import net.pterodactylus.util.beans.AbstractBean;
  26 import net.pterodactylus.util.number.Hex;
  27
  28 /**
  29  * Container for a Freenet node. A Node is capable of notifying
  30  * {@link PropertyChangeListener}s if any of the contained properties change.
  31  *
  32  * @author David ‘Bombe’ Roden &lt;bombe@freenetproject.org&gt;
  33  */
  34 public class Node extends AbstractBean {
  35
  36         /** Name of the “name” property. */
  37         public static final String PROPERTY_NAME = "name";
  38
  39         /** Name of the “hostname” property. */
  40         public static final String PROPERTY_HOSTNAME = "hostname";
  41
  42         /** Name of the “port” property. */
  43         public static final String PROPERTY_PORT = "port";
  44
  45         /** Internal ID. */
  46         private String id;
  47
  48         /** The name of the node. */
  49         private String name;
  50
  51         /** The hostname of the node. */
  52         private String hostname;
  53
  54         /** The port number of the node. */
  55         private int port;
  56
  57         /**
  58          * Creates a new node.
  59          */
  60         public Node() {
  61                 id = Hex.toHex(IdGenerator.generateId());
  62         }
  63
  64         /**
  65          * Returns the internal ID of the node.
  66          *
  67          * @return The internal ID of the node
  68          */
  69         String getId() {
  70                 return id;
  71         }
  72
  73         /**
  74          * Sets the internal ID of the node.
  75          *
  76          * @param id
  77          *            The internal ID of the node
  78          */
  79         void setId(String id) {
  80                 this.id = id;
  81         }
  82
  83         /**
  84          * Returns the user-given name of the node.
  85          *
  86          * @return The name of the node
  87          */
  88         public String getName() {
  89                 return name;
  90         }
  91
  92         /**
  93          * Sets the user-given name of the node.
  94          *
  95          * @param name
  96          *            The name of the node
  97          */
  98         public void setName(String name) {
  99                 String oldName = this.name;
 100                 this.name = name;
 101                 fireIfPropertyChanged(PROPERTY_NAME, oldName, name);
 102         }
 103
 104         /**
 105          * Returns the hostname of the node.
 106          *
 107          * @return The hostname of the node
 108          */
 109         public String getHostname() {
 110                 return hostname;
 111         }
 112
 113         /**
 114          * Sets the hostname of the node.
 115          *
 116          * @param hostname
 117          *            The hostname of the node
 118          */
 119         public void setHostname(String hostname) {
 120                 String oldHostname = this.hostname;
 121                 this.hostname = hostname;
 122                 fireIfPropertyChanged(PROPERTY_HOSTNAME, oldHostname, hostname);
 123         }
 124
 125         /**
 126          * Returns the port number of the node.
 127          *
 128          * @return The port number of the node
 129          */
 130         public int getPort() {
 131                 return port;
 132         }
 133
 134         /**
 135          * Sets the port number of the node.
 136          *
 137          * @param port
 138          *            The port number of the node
 139          */
 140         public void setPort(int port) {
 141                 int oldPort = this.port;
 142                 this.port = port;
 143                 fireIfPropertyChanged(PROPERTY_PORT, oldPort, port);
 144         }
 145
 146         /**
 147          * {@inheritDoc}
 148          */
 149         @Override
 150         public String toString() {
 151                 return name + " (" + hostname + ((port == 9481) ? ("") : (":" + port)) + ")";
 152         }
 153
 154 }