/usr/lib/python3/dist-packages/Ice/ServantLocator_ice.py is in python3-zeroc-ice 3.7.0-5.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 | # -*- coding: utf-8 -*-
# **********************************************************************
#
# Copyright (c) 2003-2017 ZeroC, Inc. All rights reserved.
#
# This copy of Ice is licensed to you under the terms described in the
# ICE_LICENSE file included in this distribution.
#
# **********************************************************************
#
# Ice version 3.7.0
#
# <auto-generated>
#
# Generated from file `ServantLocator.ice'
#
# Warning: do not edit this file.
#
# </auto-generated>
#
from sys import version_info as _version_info_
import Ice, IcePy
import Ice.ObjectAdapterF_ice
import Ice.Current_ice
# Included module Ice
_M_Ice = Ice.openModule('Ice')
# Start of module Ice
__name__ = 'Ice'
if 'ServantLocator' not in _M_Ice.__dict__:
_M_Ice.ServantLocator = Ice.createTempClass()
class ServantLocator(object):
"""
A servant locator is called by an object adapter to
locate a servant that is not found in its active servant map.
"""
def __init__(self):
if Ice.getType(self) == _M_Ice.ServantLocator:
raise RuntimeError('Ice.ServantLocator is an abstract class')
def locate(self, curr):
"""
Called before a request is dispatched if a
servant cannot be found in the object adapter's active servant
map. Note that the object adapter does not automatically insert
the returned servant into its active servant map. This must be
done by the servant locator implementation, if this is desired.
locate can throw any user exception. If it does, that exception
is marshaled back to the client. If the Slice definition for the
corresponding operation includes that user exception, the client
receives that user exception; otherwise, the client receives
UnknownUserException.
If locate throws any exception, the Ice run time does not
call finished.
If you call locate from your own code, you
must also call finished when you have finished using the
servant, provided that locate returned a non-null servant;
otherwise, you will get undefined behavior if you use
servant locators such as the Freeze Evictor.
Arguments:
curr -- Information about the current operation for which a servant is required.
Returns a tuple containing the following:
_retval -- The located servant, or null if no suitable servant has been found.
cookie -- A "cookie" that will be passed to finished.
Throws:
UserException -- The implementation can raise a UserException and the run time will marshal it as the result of the invocation.
"""
raise NotImplementedError("method 'locate' not implemented")
def finished(self, curr, servant, cookie):
"""
Called by the object adapter after a request has been
made. This operation is only called if locate was called
prior to the request and returned a non-null servant. This
operation can be used for cleanup purposes after a request.
finished can throw any user exception. If it does, that exception
is marshaled back to the client. If the Slice definition for the
corresponding operation includes that user exception, the client
receives that user exception; otherwise, the client receives
UnknownUserException.
If both the operation and finished throw an exception, the
exception thrown by finished is marshaled back to the client.
Arguments:
curr -- Information about the current operation call for which a servant was located by locate.
servant -- The servant that was returned by locate.
cookie -- The cookie that was returned by locate.
Throws:
UserException -- The implementation can raise a UserException and the run time will marshal it as the result of the invocation.
"""
raise NotImplementedError("method 'finished' not implemented")
def deactivate(self, category):
"""
Called when the object adapter in which this servant locator is
installed is destroyed.
Arguments:
category -- Indicates for which category the servant locator is being deactivated.
"""
raise NotImplementedError("method 'deactivate' not implemented")
def __str__(self):
return IcePy.stringify(self, _M_Ice._t_ServantLocator)
__repr__ = __str__
_M_Ice._t_ServantLocator = IcePy.defineValue('::Ice::ServantLocator', ServantLocator, -1, (), False, True, None, ())
ServantLocator._ice_type = _M_Ice._t_ServantLocator
_M_Ice.ServantLocator = ServantLocator
del ServantLocator
# End of module Ice
|