/** * @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");