summaryrefslogtreecommitdiffstats
path: root/src/jaegertracing/thrift/lib/erl/src/thrift_transport.erl
blob: 2414bde36368805e68271b3be5385c00f3f300fc (plain)
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
116
117
118
119
120
121
122
123
124
125
126
%%
%% Licensed to the Apache Software Foundation (ASF) under one
%% or more contributor license agreements. See the NOTICE file
%% distributed with this work for additional information
%% regarding copyright ownership. The ASF licenses this file
%% to you under the Apache License, Version 2.0 (the
%% "License"); you may not use this file except in compliance
%% with the License. You may obtain a copy of the License at
%%
%%   http://www.apache.org/licenses/LICENSE-2.0
%%
%% Unless required by applicable law or agreed to in writing,
%% software distributed under the License is distributed on an
%% "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
%% KIND, either express or implied. See the License for the
%% specific language governing permissions and limitations
%% under the License.
%%

-module(thrift_transport).

-export([behaviour_info/1]).
%% constructors
-export([new/1, new/2]).
%% transport callbacks
-export([read/2, read_exact/2, write/2, flush/1, close/1]).

-export_type([t_transport/0]).


behaviour_info(callbacks) ->
  [{read, 2}, {write, 2}, {flush, 1}, {close, 1}].


-record(t_transport, {
  module,
  state
}).

-type state() :: #t_transport{}.
-type t_transport() :: #t_transport{}.


-ifdef(transport_wrapper_module).
-define(debug_wrap(Transport),
  case Transport#t_transport.module of
    ?transport_wrapper_module -> Transport;
    _Else ->
      {ok, Result} = ?transport_wrapper_module:new(Transport),
      Result
  end
).
-else.
-define(debug_wrap(Transport), Transport).
-endif.


-type wrappable() ::
  binary() |
  list() |
  {membuffer, binary() | list()} |
  {tcp, port()} |
  {tcp, port(), list()} |
  {file, file:io_device()} |
  {file, file:io_device(), list()} |
  {file, file:filename()} |
  {file, file:filename(), list()}.

-spec new(wrappable()) -> {ok, #t_transport{}}.

new({membuffer, Membuffer}) when is_binary(Membuffer); is_list(Membuffer) ->
  thrift_membuffer_transport:new(Membuffer);
new({membuffer, Membuffer, []}) when is_binary(Membuffer); is_list(Membuffer) ->
  thrift_membuffer_transport:new(Membuffer);
new({tcp, Socket}) when is_port(Socket) ->
  new({tcp, Socket, []});
new({tcp, Socket, Opts}) when is_port(Socket) ->
  thrift_socket_transport:new(Socket, Opts);
new({file, Filename}) when is_list(Filename); is_binary(Filename) ->
  new({file, Filename, []});
new({file, Filename, Opts}) when is_list(Filename); is_binary(Filename) ->
  {ok, File} = file:open(Filename, [raw, binary]),
  new({file, File, Opts});
new({file, File, Opts}) ->
  thrift_file_transport:new(File, Opts).

-spec new(Module::module(), State::any()) -> {ok, #t_transport{}}.

new(Module, State) when is_atom(Module) ->
  {ok, ?debug_wrap(#t_transport{module = Module, state = State})}.


-include("thrift_transport_behaviour.hrl").


read(Transport = #t_transport{module = Module}, Len)
when is_integer(Len), Len >= 0 ->
  {NewState, Result} = Module:read(Transport#t_transport.state, Len),
  {Transport#t_transport{state = NewState}, Result}.


read_exact(Transport = #t_transport{module = Module}, Len)
when is_integer(Len), Len >= 0 ->
  case lists:keyfind(read_exact, 1, Module:module_info(exports)) of
    {read_exact, 2} ->
      {NewState, Result} = Module:read_exact(Transport#t_transport.state, Len),
      {Transport#t_transport{state = NewState}, Result};
    _ ->
      read(Transport, Len)
  end.


write(Transport = #t_transport{module = Module}, Data) ->
  {NewState, Result} = Module:write(Transport#t_transport.state, Data),
  {Transport#t_transport{state = NewState}, Result}.


flush(Transport = #t_transport{module = Module}) ->
  {NewState, Result} = Module:flush(Transport#t_transport.state),
  {Transport#t_transport{state = NewState}, Result}.


close(Transport = #t_transport{module = Module}) ->
  {NewState, Result} = Module:close(Transport#t_transport.state),
  {Transport#t_transport{state = NewState}, Result}.