/*
    Transit - Remote procedure calls made simple
    Copyright (c) 2012  Ulrich Hilger

    This program is free software: you can redistribute it and/or modify
    it under the terms of the GNU Affero General Public License as published by
    the Free Software Foundation, either version 3 of the License, or
    (at your option) any later version.

    This program 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 Affero General Public License for more details.

    You should have received a copy of the GNU Affero General Public License
    along with this program.  If not, see <http://www.gnu.org/licenses/>.
*/

package de.uhilger.transit.test;

/**
 * Eine Klasse zum Testen der Klassenbibliothek Transit
 * 
 * @author Copyright (c) Ulrich Hilger, http://uhilger.de
 * @author Published under the terms and conditions of
 * the <a href="http://www.gnu.org/licenses/agpl-3.0" target="_blank">GNU Affero General Public License</a>
 * 
 * @version 1, September 16, 2012
 */
public class TestKlasse {
  
  /**
   * Ein Objekt der Klasse <code>TestKlasse</code> erzeugen
   */
  public TestKlasse() {
    super();
  }
  
  /**
   * Die Zeichenkette "Hallo Welt" erzeugen
   * @return die Zeichenkette "Hallo Welt"
   */
  public String halloWelt() {
    return "Hallo Welt";
  }
  
  /**
   * Eine Begruessung erzeugen
   * @param name  der Name, der gegruesst werden soll
   * @return die Zeichenktte "Hallo [name]"
   */
  public String gruss(String name) {
    return "Hallo " + name + "!";
  }
  
  /**
   * Eine Reihe von Parametern in ein Objekt der 
   * Klasse <code>TestDatenKlasse</code> verpacken 
   * und dieses Objekt zurueckgeben
   * 
   * @param id  eine Ganzzahl, die als Identifikation der zu 
   * erzeugenden TestDatenKlasse dienen soll
   * @param text ein Text, der von der TestDatenKlasse transportiert 
   * werden soll
   * @param name der Name, den die TestDatenKlasse tragen soll
   * 
   * @return das Objekt der TestDatenKlasse mit den uebergebenen Parametern
   */
  public TestDatenKlasse getTestDaten(int id, String text, String name) {
    TestDatenKlasse t = new TestDatenKlasse();
    t.setId(id);
    t.setText(text);
    t.setName(name);
    return t;
  }
  
  /**
   * Den Namen eines Objekts der Klasse <code>TestDatenKlasse</code> 
   * ermitteln.
   * 
   * @param t  ein Objekt der Klasse  <code>TestDatenKlasse</code> 
   * @return Name des Objekts
   */
  public String testObjektVerarbeiten(TestDatenKlasse t) {
    return "Der Name des Testobjekts ist " + t.getName();
  }
}