servicebuilder.py
上传用户:king477883
上传日期:2021-03-01
资源大小:9553k
文件大小:5k
源码类别:

游戏引擎

开发平台:

C++ Builder

  1. """
  2. @file servicebuilder.py
  3. @author Phoenix
  4. @brief Class which will generate service urls.
  5. $LicenseInfo:firstyear=2007&license=mit$
  6. Copyright (c) 2007-2010, Linden Research, Inc.
  7. Permission is hereby granted, free of charge, to any person obtaining a copy
  8. of this software and associated documentation files (the "Software"), to deal
  9. in the Software without restriction, including without limitation the rights
  10. to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
  11. copies of the Software, and to permit persons to whom the Software is
  12. furnished to do so, subject to the following conditions:
  13. The above copyright notice and this permission notice shall be included in
  14. all copies or substantial portions of the Software.
  15. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  16. IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  17. FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
  18. AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  19. LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
  20. OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
  21. THE SOFTWARE.
  22. $/LicenseInfo$
  23. """
  24. from indra.base import config
  25. from indra.ipc import llsdhttp
  26. from indra.ipc import russ
  27. # *NOTE: agent presence relies on this variable existing and being current, it is a huge hack
  28. services_config = {}
  29. try:
  30.     services_config = llsdhttp.get(config.get('services-config'))
  31. except:
  32.     pass
  33. _g_builder = None
  34. def _builder():
  35.     global _g_builder
  36.     if _g_builder is None:
  37.         _g_builder = ServiceBuilder()
  38.     return _g_builder
  39. def build(name, context={}, **kwargs):
  40.     """ Convenience method for using a global, singleton, service builder.  Pass arguments either via a dict or via python keyword arguments, or both!
  41.     Example use:
  42.      > context = {'channel':'Second Life Release', 'version':'1.18.2.0'}
  43.      > servicebuilder.build('version-manager-version', context)
  44.        'http://int.util.vaak.lindenlab.com/channel/Second%20Life%20Release/1.18.2.0'
  45.      > servicebuilder.build('version-manager-version', channel='Second Life Release', version='1.18.2.0')
  46.        'http://int.util.vaak.lindenlab.com/channel/Second%20Life%20Release/1.18.2.0'
  47.      > servicebuilder.build('version-manager-version', context, version='1.18.1.2')
  48.        'http://int.util.vaak.lindenlab.com/channel/Second%20Life%20Release/1.18.1.2'
  49.     """
  50.     global _g_builder
  51.     if _g_builder is None:
  52.         _g_builder = ServiceBuilder()
  53.     return _g_builder.buildServiceURL(name, context, **kwargs)
  54. def build_path(name, context={}, **kwargs):
  55.     context = context.copy()  # shouldn't modify the caller's dictionary
  56.     context.update(kwargs)
  57.     return _builder().buildPath(name, context)
  58. class ServiceBuilder(object):
  59.     def __init__(self, services_definition = services_config):
  60.         """
  61.         @brief
  62.         @brief Create a ServiceBuilder.
  63.         @param services_definition Complete services definition, services.xml.
  64.         """
  65.         # no need to keep a copy of the services section of the
  66.         # complete services definition, but it doesn't hurt much.
  67.         self.services = services_definition['services']
  68.         self.builders = {}
  69.         for service in self.services:
  70.             service_builder = service.get('service-builder')
  71.             if not service_builder:
  72.                 continue
  73.             if isinstance(service_builder, dict):
  74.                 # We will be constructing several builders
  75.                 for name, builder in service_builder.iteritems():
  76.                     full_builder_name = service['name'] + '-' + name
  77.                     self.builders[full_builder_name] = builder
  78.             else:
  79.                 self.builders[service['name']] = service_builder
  80.     def buildPath(self, name, context):
  81.         """
  82.         @brief given the environment on construction, return a service path.
  83.         @param name The name of the service.
  84.         @param context A dict of name value lookups for the service.
  85.         @returns Returns the 
  86.         """
  87.         return russ.format(self.builders[name], context)
  88.     def buildServiceURL(self, name, context={}, **kwargs):
  89.         """
  90.         @brief given the environment on construction, return a service URL.
  91.         @param name The name of the service.
  92.         @param context A dict of name value lookups for the service.
  93.         @param kwargs Any keyword arguments are treated as members of the
  94.             context, this allows you to be all 31337 by writing shit like:
  95.             servicebuilder.build('name', param=value)
  96.         @returns Returns the 
  97.         """
  98.         context = context.copy()  # shouldn't modify the caller's dictionary
  99.         context.update(kwargs)
  100.         base_url = config.get('services-base-url')
  101.         svc_path = russ.format(self.builders[name], context)
  102.         return base_url + svc_path
  103. def on_in(query_name, host_key, schema_key):
  104.     """
  105.     @brief Constructs an on/in snippet (for running named queries)
  106.     from a schema name and two keys referencing values stored in
  107.     indra.xml.
  108.     @param query_name Name of the query.
  109.     @param host_key Logical name of destination host.  Will be
  110.         looked up in indra.xml.
  111.     @param schema_key Logical name of destination schema.  Will
  112.         be looked up in indra.xml.
  113.     """
  114.     return "on/config:%s/in/config:%s/%s" % (host_key.strip('/'),
  115.                                              schema_key.strip('/'),
  116.                                              query_name.lstrip('/'))