声明一个接口节俭
declare an interface thrift
如何在 Thrift 中声明接口?我的意思是我有接口 IClient 并且我将它用作服务器中登录函数的参数:
public interface IServer {
void login(Pers pers, IClient client) throws ConcursException;
}
我必须使用 Thrift(Java 服务器,C# 客户端),但我不知道如何声明在登录功能中使用它的接口。
这是 IClient 接口:
public interface IClient
{
void increasedNrParticipants(Proba proba);
}
谢谢!
如 tutorial and the syntax documentation 所示,尽管与 Thrift 一起使用的语言称为 IDL(接口定义语言),但并不在 Thrift 中声明接口,而是声明 service
:
service MyCoolService {
void login(1: Pers pers, 2: Client client) throws (1: ConcursException ce)
}
除内置基本数据类型和容器外,任何要使用的类型都必须声明:
enum creditibility {
excellent, quite_good, medium_ok, could_be_worse, omg
}
struct Pers {
1: string surname
2: string firstname
3: i32 age
}
struct Client {
1: i32 client_number
2: string company_name
3: Pers contact
4: creditibility creditibility
}
以相同方式声明异常:
exception ConcursException {
1: bool chapter7
2: bool chapter11
3: double outstanding_amount
}
上述语法的所有细节在 Apache Thrift 网站和当今市场上 all the other, additional documentation available 上都有更详细的解释。
通过使用 Thrift 编译器,可以从该 IDL 生成一些代码,然后像往常一样编译并链接到您的程序中。在我们的例子中,我们需要 Java 代码。假设,我们将上面的所有声明保存在一个名为 myfile.thrift
的文件中,我们输入:
thrift -gen java myfile.thrift
再次强调,强烈推荐走遍tutorial。它不需要那么多时间,但会教授很多有关 Thrift 工作原理的基础知识。
此外,请查看 the test suite code 以了解有关增强概念的更多信息,例如 Thrift 中的替代端点传输、分层传输和协议。
I have the interface IClient and I use it as parameter in login function in Server
Thrift 使用的所有类型必须是内置基本类型,或者必须使用 IDL 定义。所以这种方法不起作用,因为 IClient
不是 IDL 定义的类型。
有一个使用标准thrift Protocol的RPC框架"thrifty",和使用thrift IDL定义服务是一样的效果,thrify可以兼容使用thrift的代码IDL,对跨平台很有帮助,它使用了DotNetty(windows是iocp,linux是nio)
[ThriftStruct]
public class LogEntry
{
[ThriftConstructor]
public LogEntry([ThriftField(1)]String category, [ThriftField(2)]String message)
{
this.Category = category;
this.Message = message;
}
[ThriftField(1)]
public String Category { get; }
[ThriftField(2)]
public String Message { get; }
}
[ThriftService("scribe")]
public interface IScribe
{
[ThriftMethod("getMessages")]
List<LogEntry> GetMessages();
[ThriftMethod]
ResultCode Log(List<LogEntry> messages);
}
public class Scribe : IScribe
{
public List<LogEntry> GetMessages()
{
return new List<LogEntry>
{
new LogEntry { Category = "c1", Message = Guid.NewGuid().ToString() },
new LogEntry { Category = "c2", Message = Guid.NewGuid().ToString() },
new LogEntry { Category = "c3", Message = Guid.NewGuid().ToString() }
};
}
public ResultCode Log(List<LogEntry> messages)
{
return ResultCode.TRY_LATER;
}
}
如何在 Thrift 中声明接口?我的意思是我有接口 IClient 并且我将它用作服务器中登录函数的参数:
public interface IServer {
void login(Pers pers, IClient client) throws ConcursException;
}
我必须使用 Thrift(Java 服务器,C# 客户端),但我不知道如何声明在登录功能中使用它的接口。
这是 IClient 接口:
public interface IClient
{
void increasedNrParticipants(Proba proba);
}
谢谢!
如 tutorial and the syntax documentation 所示,尽管与 Thrift 一起使用的语言称为 IDL(接口定义语言),但并不在 Thrift 中声明接口,而是声明 service
:
service MyCoolService {
void login(1: Pers pers, 2: Client client) throws (1: ConcursException ce)
}
除内置基本数据类型和容器外,任何要使用的类型都必须声明:
enum creditibility {
excellent, quite_good, medium_ok, could_be_worse, omg
}
struct Pers {
1: string surname
2: string firstname
3: i32 age
}
struct Client {
1: i32 client_number
2: string company_name
3: Pers contact
4: creditibility creditibility
}
以相同方式声明异常:
exception ConcursException {
1: bool chapter7
2: bool chapter11
3: double outstanding_amount
}
上述语法的所有细节在 Apache Thrift 网站和当今市场上 all the other, additional documentation available 上都有更详细的解释。
通过使用 Thrift 编译器,可以从该 IDL 生成一些代码,然后像往常一样编译并链接到您的程序中。在我们的例子中,我们需要 Java 代码。假设,我们将上面的所有声明保存在一个名为 myfile.thrift
的文件中,我们输入:
thrift -gen java myfile.thrift
再次强调,强烈推荐走遍tutorial。它不需要那么多时间,但会教授很多有关 Thrift 工作原理的基础知识。
此外,请查看 the test suite code 以了解有关增强概念的更多信息,例如 Thrift 中的替代端点传输、分层传输和协议。
I have the interface IClient and I use it as parameter in login function in Server
Thrift 使用的所有类型必须是内置基本类型,或者必须使用 IDL 定义。所以这种方法不起作用,因为 IClient
不是 IDL 定义的类型。
有一个使用标准thrift Protocol的RPC框架"thrifty",和使用thrift IDL定义服务是一样的效果,thrify可以兼容使用thrift的代码IDL,对跨平台很有帮助,它使用了DotNetty(windows是iocp,linux是nio)
[ThriftStruct]
public class LogEntry
{
[ThriftConstructor]
public LogEntry([ThriftField(1)]String category, [ThriftField(2)]String message)
{
this.Category = category;
this.Message = message;
}
[ThriftField(1)]
public String Category { get; }
[ThriftField(2)]
public String Message { get; }
}
[ThriftService("scribe")]
public interface IScribe
{
[ThriftMethod("getMessages")]
List<LogEntry> GetMessages();
[ThriftMethod]
ResultCode Log(List<LogEntry> messages);
}
public class Scribe : IScribe
{
public List<LogEntry> GetMessages()
{
return new List<LogEntry>
{
new LogEntry { Category = "c1", Message = Guid.NewGuid().ToString() },
new LogEntry { Category = "c2", Message = Guid.NewGuid().ToString() },
new LogEntry { Category = "c3", Message = Guid.NewGuid().ToString() }
};
}
public ResultCode Log(List<LogEntry> messages)
{
return ResultCode.TRY_LATER;
}
}