/*
 * Copyright © 2004-2007 by SAP AG.
 * All Rights Reserved.
 * 
 * SAP, R/3, mySAP, mySAP.com, xApps, xApp, SAP NetWeaver, and other SAP
 * products and services mentioned herein as well as their respective logos are
 * trademarks or registered trademarks of SAP AG in Germany and in several other
 * countries all over the world. All other product and service names mentioned
 * are the trademarks of their respective companies. Data contained in this
 * document serves informational purposes only. National product specifications
 * may vary.
 * 
 * These materials are subject to change without notice. These materials are
 * provided by SAP AG and its affiliated companies (SAP Group) for informational
 * purposes only, without representation or warranty of any kind, and SAP Group
 * shall not be liable for errors or omissions with respect to the materials.
 * The only warranties for SAP Group products and services are those that are
 * set forth in the express warranty statements accompanying such products and
 * services, if any. Nothing herein should be construed as constituting an
 * additional warranty.
 * 
 */
 
package com.sap.mdm.examples;

import com.sap.mdm.commands.CommandException;
import com.sap.mdm.net.ConnectionException;
import com.sap.mdm.net.SimpleConnection;
import com.sap.mdm.net.SimpleConnectionFactory;
import com.sap.mdm.server.commands.GetServerVersionCommand;

/**
 * This example shows you how to create a simple connection and 
 * execute the session-less command <code>GetServerVersionCommand</code>.
 * 
 * The first thing the program does is to create a connection using the <code>getInstance()</code> 
 * method of the <code>SimpleConnectionFactory</code> class. 
 * This method requires a string argument as a ConnectionTag. 
 * The ConnectionTag is the host name of the MDM Server, plus an optional TCP/IP port number 
 * on which the server listens. The format is &lt;host name or IP address&gt;[;&ltport number&gt;]. 
 * If no port number is given, the default port 59950 is used.<br>
 * Examples for ConnectionTag:<br>
 * <em>localhost</em> – connection the locally installed MDM server is created, using the default port.<br>
 * <em>some.server.com;41003</em> – connection using the non standard port 41003.<br>
 * Note: Configuring the MDM Server to listen on a different port than the default port is not yet available.<br>
 * <br>
 * If for any reason the connection can not be established, the factory class throws a <code>ConnectionException</code>.
 * <br>
 * Then an instance of the command <code>GetServerVersionCommand</code> is created. 
 * As for any command, the constructor requires the used connection as an argument.
 * Since this command does not need any further arguments, the <code>execute()</code> method is called,
 *  which sends the command to the server and waits for the result.
 * <br>
 * Any error after the calling of the <code>execute()</code> method will result in an <code>CommandException</code> being thrown.
 * <br>
 * Finally the result can be retrieved from the command using the <code>getVersion()</code> method, 
 * which returns the build version of the MDM Server as a string.
 * <br>
 * <br>
 * <a href="GetServerVersion.java">Source code for GetServerVersion.java</a>
 */
public class GetServerVersion {
    private GetServerVersion() {        
    }
    
    public static void main(String[] args) {
        // Create a connection to the MDM Server on
        // the local host by requesting a ConnectionAccessor from
        // the SimpleConnectionFactory using the getInstance() method.
        String connectionTag = "LOCALHOST";
        SimpleConnection connection = null;
        try {
            connection = SimpleConnectionFactory.getInstance(connectionTag);
        } catch (ConnectionException e) {
            e.printStackTrace();
            return;
        }
        
        // Instantiate a GetServerVersionCommand. As for every command
        // the constructor requires the connection to be used as an argument.
        // There is no need establich a session, since this is one of the 
        // few commands that do not require a session.
        GetServerVersionCommand cmd = new GetServerVersionCommand(connection);
        try {
        	// Execute the command
            cmd.execute();
        } catch (CommandException e) {
            e.printStackTrace();
            return;
        }        
        
        // Retrieve the result of the command - the version of the MDM Server -
        // using the getVersion() method  
        System.out.println("MDM server version: " + cmd.getVersion());
    }
}