src/network/lscpresultset.cpp

/***************************************************************************
 *                                                                         *
 *   LinuxSampler - modular, streaming capable sampler                     *
 *                                                                         *
 *   Copyright (C) 2003, 2004 by Benno Senoner and Christian Schoenebeck   *
 *                                                                         *
 *   This program is free software; you can redistribute it and/or modify  *
 *   it under the terms of the GNU General Public License as published by  *
 *   the Free Software Foundation; either version 2 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 General Public License for more details.                          *
 *                                                                         *
 *   You should have received a copy of the GNU General Public License     *
 *   along with this program; if not, write to the Free Software           *
 *   Foundation, Inc., 59 Temple Place, Suite 330, Boston,                 *
 *   MA  02111-1307  USA                                                   *
 ***************************************************************************/

/*********************************************************
 * This class helps to constuct valid resultsets per
 * LSCP protocol specification
 *
 * Valid results include:
 * OK - to ack the request
 * Single line to ack the requests and give status
 * Several lines of information in the following format:
 * LABEL0: VALUE0
 * LABEL1: VALUE1
 * VALELx: VALUEx
 * .
 *
 * ******************************************************/

#include "lscpresultset.h"

//Construct an empty resultset
//Default index is -1 meaning the resultset doesn't have an index
LSCPResultSet::LSCPResultSet(int index) {
        result_index = index;
        count = 0;
        storage = "";
        result_type = result_type_success;
}

//Construct a resultset with a single line
//Default index is -1 meaning the resultset doesn't have an index
LSCPResultSet::LSCPResultSet(String Value, int index) {
        result_index = index;
        count = 1;
        storage = Value + "\r\n";
        result_type = result_type_success;
}

//Add a label/value pair to the resultset
//Values could be of different types for now supports String, int and float.
void LSCPResultSet::Add(String Label, String Value) {
        if (count == -1)
                throw LinuxSamplerException("Attempting to change already produced resultset");
        if (result_type != result_type_success)
                throw LinuxSamplerException("Attempting to create illegal resultset");
        storage = storage + Label + ": " + Value + "\r\n";
        count++;
}

void LSCPResultSet::Add(int Value) {
        Add(ToString(Value));
}

void LSCPResultSet::Add(String Label, int Value) {
        Add(Label, ToString(Value));
}

void LSCPResultSet::Add(String Label, float Value) {
        std::stringstream ss; //fixme: had issues with template and float?!
        ss << Value;
        Add(Label, ss.str());
}

void LSCPResultSet::Add(String Label, bool Value) {
    String s = (Value) ? "true" : "false";
    Add(Label, s);
}

//Add a single string to the resultset
void LSCPResultSet::Add(String Value) {
        if (result_type != result_type_success)
                throw LinuxSamplerException("Attempting to create illegal resultset");
        if (count == -1)
                throw LinuxSamplerException("Attempting to change already produced resultset");
        if (count != 0)
                throw LinuxSamplerException("Attempting to create illegal resultset");
        storage = Value + "\r\n";
        count = 1;
}

//Generate an error result set from an exception.
//Per LSCP spec, error result is a sinle line in the following format:
//ERR:<CODE>:Message text\r\n
//This method will be used to generate unknown errors only (code 0)
//To generate errors with other codes as well as warnings use other methods (below).
//Because this is an unknown error, this method will also print message to the stderr.
void LSCPResultSet::Error(LinuxSamplerException e) {
        e.PrintMessage();
        Error(e.Message());
}

//This will construct an error with a string and error code
//code has a default of 0
//String has a default of "Undefined Error"
void LSCPResultSet::Error (String message, int code) {
        //Even though this is must be a single line resultset we won't throw
        //anything here because this is already part of exception handling.
        //We'll just 'forget' all previous results (if any) from this resultset.
        result_type = result_type_error;
        storage = "ERR:" + ToString(code) + ":" + message + "\r\n";
        count = 1;
}

//This will construct a warning with a string and error code
//code has a default of 0
//String has a default of "Undefined Error"
void LSCPResultSet::Warning (String message, int code) {
        //FIXME: DO we want warnings as part of the resultset or
        //do we want them to work like errors??? For now, make them work like errors.
        result_type = result_type_warning;
        if (result_index == -1)
                storage = "WRN:" + ToString(code) + ":" + message + "\r\n";
        else
                storage = "WRN[" + ToString(result_index) + "]:" + ToString(code) + ":" + message + "\r\n";
        count = 1;
}

//Produce resultset
String LSCPResultSet::Produce(void) {
        //FIXME: I'm assuming that only a sinle like "OK" can have index
        if (count == 0) //When there is nothing in the resultset we just send "OK" to ack the request
                if (result_index == -1)
                        return "OK\r\n";
                else
                        return "OK[" + ToString(result_index) + "]\r\n";
        if (count == 1) //Single line results are just that, single line
                return storage;
        //Multiline results MUST end with a line with a single dot
        return storage + ".\r\n";
}
1	senkov	113	/***************************************************************************
2			* *
3			* LinuxSampler - modular, streaming capable sampler *
4			* *
5			* Copyright (C) 2003, 2004 by Benno Senoner and Christian Schoenebeck *
6			* *
7			* This program is free software; you can redistribute it and/or modify *
8			* it under the terms of the GNU General Public License as published by *
9			* the Free Software Foundation; either version 2 of the License, or *
10			* (at your option) any later version. *
11			* *
12			* This program is distributed in the hope that it will be useful, *
13			* but WITHOUT ANY WARRANTY; without even the implied warranty of *
14			* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the *
15			* GNU General Public License for more details. *
16			* *
17			* You should have received a copy of the GNU General Public License *
18			* along with this program; if not, write to the Free Software *
19			* Foundation, Inc., 59 Temple Place, Suite 330, Boston, *
20			* MA 02111-1307 USA *
21			***************************************************************************/
22
23	senkov	116	/*********************************************************
24			* This class helps to constuct valid resultsets per
25			* LSCP protocol specification
26			*
27			* Valid results include:
28			* OK - to ack the request
29			* Single line to ack the requests and give status
30			* Several lines of information in the following format:
31			* LABEL0: VALUE0
32			* LABEL1: VALUE1
33			* VALELx: VALUEx
34			* .
35			*
36			* ******************************************************/
37
38	senkov	113	#include "lscpresultset.h"
39
40	senkov	116	//Construct an empty resultset
41	senkov	120	//Default index is -1 meaning the resultset doesn't have an index
42			LSCPResultSet::LSCPResultSet(int index) {
43			result_index = index;
44	senkov	113	count = 0;
45			storage = "";
46	senkov	120	result_type = result_type_success;
47	senkov	113	}
48
49	senkov	116	//Construct a resultset with a single line
50	senkov	120	//Default index is -1 meaning the resultset doesn't have an index
51			LSCPResultSet::LSCPResultSet(String Value, int index) {
52			result_index = index;
53	senkov	113	count = 1;
54			storage = Value + "\r\n";
55	senkov	120	result_type = result_type_success;
56	senkov	113	}
57
58	senkov	116	//Add a label/value pair to the resultset
59			//Values could be of different types for now supports String, int and float.
60	senkov	113	void LSCPResultSet::Add(String Label, String Value) {
61			if (count == -1)
62			throw LinuxSamplerException("Attempting to change already produced resultset");
63	senkov	120	if (result_type != result_type_success)
64			throw LinuxSamplerException("Attempting to create illegal resultset");
65	senkov	113	storage = storage + Label + ": " + Value + "\r\n";
66			count++;
67			}
68
69	senkov	120	void LSCPResultSet::Add(int Value) {
70			Add(ToString(Value));
71			}
72
73	senkov	113	void LSCPResultSet::Add(String Label, int Value) {
74	senkov	120	Add(Label, ToString(Value));
75	senkov	113	}
76
77			void LSCPResultSet::Add(String Label, float Value) {
78	senkov	120	std::stringstream ss; //fixme: had issues with template and float?!
79			ss << Value;
80			Add(Label, ss.str());
81	senkov	113	}
82
83	schoenebeck	223	void LSCPResultSet::Add(String Label, bool Value) {
84			String s = (Value) ? "true" : "false";
85			Add(Label, s);
86			}
87
88	senkov	116	//Add a single string to the resultset
89	senkov	113	void LSCPResultSet::Add(String Value) {
90	senkov	120	if (result_type != result_type_success)
91			throw LinuxSamplerException("Attempting to create illegal resultset");
92	senkov	113	if (count == -1)
93			throw LinuxSamplerException("Attempting to change already produced resultset");
94			if (count != 0)
95			throw LinuxSamplerException("Attempting to create illegal resultset");
96			storage = Value + "\r\n";
97			count = 1;
98			}
99
100	senkov	120	//Generate an error result set from an exception.
101			//Per LSCP spec, error result is a sinle line in the following format:
102			//ERR:<CODE>:Message text\r\n
103			//This method will be used to generate unknown errors only (code 0)
104			//To generate errors with other codes as well as warnings use other methods (below).
105			//Because this is an unknown error, this method will also print message to the stderr.
106			void LSCPResultSet::Error(LinuxSamplerException e) {
107			e.PrintMessage();
108			Error(e.Message());
109			}
110
111			//This will construct an error with a string and error code
112			//code has a default of 0
113			//String has a default of "Undefined Error"
114			void LSCPResultSet::Error (String message, int code) {
115			//Even though this is must be a single line resultset we won't throw
116			//anything here because this is already part of exception handling.
117			//We'll just 'forget' all previous results (if any) from this resultset.
118			result_type = result_type_error;
119			storage = "ERR:" + ToString(code) + ":" + message + "\r\n";
120			count = 1;
121			}
122
123			//This will construct a warning with a string and error code
124			//code has a default of 0
125			//String has a default of "Undefined Error"
126			void LSCPResultSet::Warning (String message, int code) {
127			//FIXME: DO we want warnings as part of the resultset or
128			//do we want them to work like errors??? For now, make them work like errors.
129			result_type = result_type_warning;
130			if (result_index == -1)
131			storage = "WRN:" + ToString(code) + ":" + message + "\r\n";
132			else
133			storage = "WRN[" + ToString(result_index) + "]:" + ToString(code) + ":" + message + "\r\n";
134			count = 1;
135			}
136
137	senkov	116	//Produce resultset
138	senkov	113	String LSCPResultSet::Produce(void) {
139	senkov	120	//FIXME: I'm assuming that only a sinle like "OK" can have index
140	senkov	116	if (count == 0) //When there is nothing in the resultset we just send "OK" to ack the request
141	senkov	120	if (result_index == -1)
142			return "OK\r\n";
143			else
144			return "OK[" + ToString(result_index) + "]\r\n";
145	senkov	116	if (count == 1) //Single line results are just that, single line
146	senkov	113	return storage;
147	senkov	116	//Multiline results MUST end with a line with a single dot
148	senkov	113	return storage + ".\r\n";
149			}