Jens Geyer created THRIFT-2586:
----------------------------------

             Summary: Towards a more consistent FileTransport naming scheme
                 Key: THRIFT-2586
                 URL: https://issues.apache.org/jira/browse/THRIFT-2586
             Project: Thrift
          Issue Type: Improvement
          Components: Wish List
            Reporter: Jens Geyer


I just did some research across the /lib folder too find out, what kinds of 
file transports are supported by the various languages. This is what I found:

Cocoa
- TNSFileHandleTransport 

C++
- TFileTransport
- TSimpleFileTransport
- TPipedFileReaderTransport

D
- TFileReaderTransport / TFileWriterTransport 

Erlang
- thrift_disk_log_transport.erl 

Java
- TFileTransport
- TSimpleFileTransport

Python
- TFileObjectTransport

Obviously, we have a somewhat inconsistent naming scheme. Next, the difference 
between a {{TFileTransport}} and a {{TSimpleFileTransport}} is not deductable 
by the name, and it is not intuitively clear what transport to use in which 
case without looking at the implementation of both transports. 

If we stick with Java as an example, {{TSimpleFileTransport}} just means, that 
this is the *real* file transport, while the {{TFileTransport}} should be 
called {{TFramedChunkedFileTransport}}, because that's what it is. 

Once we found a good naming scheme, all other file transports should be named 
after that scheme, as appropriate. This makes it more easy to the Thrift user 
and prevents errors due to incompatible transports caused by bad names 
(THRIFT-2582).

I'd like to hear your opinions.




--
This message was sent by Atlassian JIRA
(v6.2#6252)

Reply via email to