| # Copyright 2015-2016, Google Inc. |
| # All rights reserved. |
| # |
| # Redistribution and use in source and binary forms, with or without |
| # modification, are permitted provided that the following conditions are |
| # met: |
| # |
| # * Redistributions of source code must retain the above copyright |
| # notice, this list of conditions and the following disclaimer. |
| # * Redistributions in binary form must reproduce the above |
| # copyright notice, this list of conditions and the following disclaimer |
| # in the documentation and/or other materials provided with the |
| # distribution. |
| # * Neither the name of Google Inc. nor the names of its |
| # contributors may be used to endorse or promote products derived from |
| # this software without specific prior written permission. |
| # |
| # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS |
| # "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT |
| # LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR |
| # A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT |
| # OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, |
| # SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT |
| # LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, |
| # DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY |
| # THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT |
| # (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE |
| # OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
| |
| """Beta API server implementation.""" |
| |
| import threading |
| |
| from grpc._links import service |
| from grpc.beta import interfaces |
| from grpc.framework.core import implementations as _core_implementations |
| from grpc.framework.crust import implementations as _crust_implementations |
| from grpc.framework.foundation import logging_pool |
| from grpc.framework.interfaces.base import base |
| from grpc.framework.interfaces.links import utilities |
| |
| _DEFAULT_POOL_SIZE = 8 |
| _DEFAULT_TIMEOUT = 300 |
| _MAXIMUM_TIMEOUT = 24 * 60 * 60 |
| |
| |
| def _set_event(): |
| event = threading.Event() |
| event.set() |
| return event |
| |
| |
| class _GRPCServicer(base.Servicer): |
| |
| def __init__(self, delegate): |
| self._delegate = delegate |
| |
| def service(self, group, method, context, output_operator): |
| try: |
| return self._delegate.service(group, method, context, output_operator) |
| except base.NoSuchMethodError as e: |
| if e.code is None and e.details is None: |
| raise base.NoSuchMethodError( |
| interfaces.StatusCode.UNIMPLEMENTED, |
| 'Method "%s" of service "%s" not implemented!' % (method, group)) |
| else: |
| raise |
| |
| |
| class _Server(interfaces.Server): |
| |
| def __init__( |
| self, implementations, multi_implementation, pool, pool_size, |
| default_timeout, maximum_timeout, grpc_link): |
| self._lock = threading.Lock() |
| self._implementations = implementations |
| self._multi_implementation = multi_implementation |
| self._customer_pool = pool |
| self._pool_size = pool_size |
| self._default_timeout = default_timeout |
| self._maximum_timeout = maximum_timeout |
| self._grpc_link = grpc_link |
| |
| self._end_link = None |
| self._stop_events = None |
| self._pool = None |
| |
| def _start(self): |
| with self._lock: |
| if self._end_link is not None: |
| raise ValueError('Cannot start already-started server!') |
| |
| if self._customer_pool is None: |
| self._pool = logging_pool.pool(self._pool_size) |
| assembly_pool = self._pool |
| else: |
| assembly_pool = self._customer_pool |
| |
| servicer = _GRPCServicer( |
| _crust_implementations.servicer( |
| self._implementations, self._multi_implementation, assembly_pool)) |
| |
| self._end_link = _core_implementations.service_end_link( |
| servicer, self._default_timeout, self._maximum_timeout) |
| |
| self._grpc_link.join_link(self._end_link) |
| self._end_link.join_link(self._grpc_link) |
| self._grpc_link.start() |
| self._end_link.start() |
| |
| def _dissociate_links_and_shut_down_pool(self): |
| self._grpc_link.end_stop() |
| self._grpc_link.join_link(utilities.NULL_LINK) |
| self._end_link.join_link(utilities.NULL_LINK) |
| self._end_link = None |
| if self._pool is not None: |
| self._pool.shutdown(wait=True) |
| self._pool = None |
| |
| def _stop_stopping(self): |
| self._dissociate_links_and_shut_down_pool() |
| for stop_event in self._stop_events: |
| stop_event.set() |
| self._stop_events = None |
| |
| def _stop_started(self): |
| self._grpc_link.begin_stop() |
| self._end_link.stop(0).wait() |
| self._dissociate_links_and_shut_down_pool() |
| |
| def _foreign_thread_stop(self, end_stop_event, stop_events): |
| end_stop_event.wait() |
| with self._lock: |
| if self._stop_events is stop_events: |
| self._stop_stopping() |
| |
| def _schedule_stop(self, grace): |
| with self._lock: |
| if self._end_link is None: |
| return _set_event() |
| server_stop_event = threading.Event() |
| if self._stop_events is None: |
| self._stop_events = [server_stop_event] |
| self._grpc_link.begin_stop() |
| else: |
| self._stop_events.append(server_stop_event) |
| end_stop_event = self._end_link.stop(grace) |
| end_stop_thread = threading.Thread( |
| target=self._foreign_thread_stop, |
| args=(end_stop_event, self._stop_events)) |
| end_stop_thread.start() |
| return server_stop_event |
| |
| def _stop_now(self): |
| with self._lock: |
| if self._end_link is not None: |
| if self._stop_events is None: |
| self._stop_started() |
| else: |
| self._stop_stopping() |
| |
| def add_insecure_port(self, address): |
| with self._lock: |
| if self._end_link is None: |
| return self._grpc_link.add_port(address, None) |
| else: |
| raise ValueError('Can\'t add port to serving server!') |
| |
| def add_secure_port(self, address, server_credentials): |
| with self._lock: |
| if self._end_link is None: |
| return self._grpc_link.add_port( |
| address, server_credentials._low_credentials) # pylint: disable=protected-access |
| else: |
| raise ValueError('Can\'t add port to serving server!') |
| |
| def start(self): |
| self._start() |
| |
| def stop(self, grace): |
| if 0 < grace: |
| return self._schedule_stop(grace) |
| else: |
| self._stop_now() |
| return _set_event() |
| |
| def __enter__(self): |
| self._start() |
| return self |
| |
| def __exit__(self, exc_type, exc_val, exc_tb): |
| self._stop_now() |
| return False |
| |
| def __del__(self): |
| self._stop_now() |
| |
| |
| def server( |
| implementations, multi_implementation, request_deserializers, |
| response_serializers, thread_pool, thread_pool_size, default_timeout, |
| maximum_timeout): |
| grpc_link = service.service_link(request_deserializers, response_serializers) |
| return _Server( |
| implementations, multi_implementation, thread_pool, |
| _DEFAULT_POOL_SIZE if thread_pool_size is None else thread_pool_size, |
| _DEFAULT_TIMEOUT if default_timeout is None else default_timeout, |
| _MAXIMUM_TIMEOUT if maximum_timeout is None else maximum_timeout, |
| grpc_link) |