Files
SingularityViewer/indra/llmessage/llsdhttpserver.cpp
2010-11-21 15:57:44 +01:00

157 lines
3.8 KiB
C++

/**
* @file llsdhttpserver.cpp
* @brief Standard LLSD services
*
* $LicenseInfo:firstyear=2006&license=viewergpl$
*
* Copyright (c) 2006-2009, Linden Research, Inc.
*
* Second Life Viewer Source Code
* The source code in this file ("Source Code") is provided by Linden Lab
* to you under the terms of the GNU General Public License, version 2.0
* ("GPL"), unless you have obtained a separate licensing agreement
* ("Other License"), formally executed by you and Linden Lab. Terms of
* the GPL can be found in doc/GPL-license.txt in this distribution, or
* online at http://secondlifegrid.net/programs/open_source/licensing/gplv2
*
* There are special exceptions to the terms and conditions of the GPL as
* it is applied to this Source Code. View the full text of the exception
* in the file doc/FLOSS-exception.txt in this software distribution, or
* online at
* http://secondlifegrid.net/programs/open_source/licensing/flossexception
*
* By copying, modifying or distributing this software, you acknowledge
* that you have read and understood your obligations described above,
* and agree to abide by those obligations.
*
* ALL LINDEN LAB SOURCE CODE IS PROVIDED "AS IS." LINDEN LAB MAKES NO
* WARRANTIES, EXPRESS, IMPLIED OR OTHERWISE, REGARDING ITS ACCURACY,
* COMPLETENESS OR PERFORMANCE.
* $/LicenseInfo$
*/
#include "linden_common.h"
#include "llsdhttpserver.h"
#include "llhttpnode.h"
/**
* This module implements common services that should be included
* in all server URL trees. These services facilitate debugging and
* introsepction.
*/
void LLHTTPStandardServices::useServices()
{
/*
Having this function body here, causes the classes and globals in this
file to be linked into any program that uses the llmessage library.
*/
}
class LLHTTPHelloService : public LLHTTPNode
{
public:
virtual void describe(Description& desc) const
{
desc.shortInfo("says hello");
desc.getAPI();
desc.output("\"hello\"");
desc.source(__FILE__, __LINE__);
}
virtual LLSD simpleGet() const
{
LLSD result = "hello";
return result;
}
};
LLHTTPRegistration<LLHTTPHelloService>
gHTTPRegistrationWebHello("/web/hello");
class LLHTTPEchoService : public LLHTTPNode
{
public:
virtual void describe(Description& desc) const
{
desc.shortInfo("echo input");
desc.postAPI();
desc.input("<any>");
desc.output("<the input>");
desc.source(__FILE__, __LINE__);
}
virtual LLSD simplePost(const LLSD& params) const
{
return params;
}
};
LLHTTPRegistration<LLHTTPEchoService>
gHTTPRegistrationWebEcho("/web/echo");
class LLAPIService : public LLHTTPNode
{
public:
virtual void describe(Description& desc) const
{
desc.shortInfo("information about the URLs this server supports");
desc.getAPI();
desc.output("a list of URLs supported");
desc.source(__FILE__, __LINE__);
}
virtual bool handles(const LLSD& remainder, LLSD& context) const
{
return followRemainder(remainder) != NULL;
}
virtual void get(ResponsePtr response, const LLSD& context) const
{
const LLSD& remainder = context["request"]["remainder"];
if (remainder.size() > 0)
{
const LLHTTPNode* node = followRemainder(remainder);
if (!node)
{
response->notFound();
return;
}
Description desc;
node->describe(desc);
response->result(desc.getInfo());
return;
}
response->result(rootNode()->allNodePaths());
}
private:
const LLHTTPNode* followRemainder(const LLSD& remainder) const
{
const LLHTTPNode* node = rootNode();
LLSD::array_const_iterator i = remainder.beginArray();
LLSD::array_const_iterator end = remainder.endArray();
for (; node && i != end; ++i)
{
node = node->findNode(*i);
}
return node;
}
};
LLHTTPRegistration<LLAPIService>
gHTTPRegistrationWebServerApi("/web/server/api");