HttpMate简介

没有人愿意编写不良代码。没有人会想到“我要创建最纠结和最不可读的代码，并确保它不可扩展且难以修改或浏览”，从而开始了应用程序开发。首先要有良好的意愿，甚至可能要牢记所有Clean Code和SOLID原则。但是，折衷方案通常以所涉及的外部依赖关系的数量为基础，开始快速蔓延和倍增。

令人羡慕的是，我们没有找到任何框架使我们能够开发Web应用程序，并良心宣称其业务逻辑不依赖于基础HTTP服务器，持久层或（反）序列化机制（也在DDD中称为“基础结构代码”）。

如果您也觉得自己不再开发应用程序，而是继续“集成”和“集成”框架，与它的恶魔抗争，并且从没有时间来使用实际的业务逻辑。如果您还只是因为发布了新版本的框架而对无休止的重构感到厌倦。如果您不确定要使用哪个批注，并且对使用的HTTP框架的入侵性感到坦白，那么HttpMate适合您。

它是非侵入性的，灵活的和超可扩展的。 HttpMate为您提供3种处理HTTP请求的模式-UseCase驱动的，低级HTTP和事件驱动的请求处理，以及混合这些模式以充分利用功能丰富的框架。

没有更多的理由，让我们看一些代码示例。

低级HTTP请求处理

final HttpMate httpMate = HttpMate.aLowLevelHttpMate().get("/api/hello", (httpRequest, httpResponse) -> {final Optional<String> name = httpRequest.queryParameters().getQueryParameter("name");httpResponse.setBody("Hello " + name.orElse("World"));httpResponse.setStatus(OK);}).build();

本文使用HttpMate的低级HTTP构建器，它只是探讨了可能性的表面。
您可以轻松地为任何path / http方法组合注册处理程序。在处理程序lambda中，您可以使用请求和响应对象，处理程序可以根据需要变得复杂。
请查看存储库的示例部分，以获取有关低级API的更多信息。

您可能已经看到其他所有HTTP框架都提供了一种编写少量请求处理程序的简便方法，尽管这是介绍框架语法的好方法，也是一种出色的营销工具，但任何现实生活中的挑战都不仅仅是“只需通过函数调用处理请求”。全世界都迫切需要一个HTTP框架，该框架将在请求处理和业务逻辑之间提供适当的抽象层，并允许您在重要的事情上不妥协-干净的体系结构和可扩展性。

UseCase示例

HttpMate允许您“仅将业务逻辑发布为HTTP端点”。让我们探讨一下发送电子邮件以证明这一点的用例。

我们尚不知道HTTP端点的外观，但是我们知道我们需要一个Email对象来表示电子邮件的详细信息：

发件人
接收者
学科
身体

我们需要返回，假设每发送一封电子邮件都会有一个回执：

追踪号码
日期

并且我们有一个负责发送电子邮件的类，看起来像这样：

public class SendEmailUseCase {...public Receipt sendEmail(final Email email) { ...}...
}

现在，您已经可以使用HttpMate构建器来发布该用例-假设您已经决定了哪个URL和哪种HTTP方法将负责向用户提供此UseCase：

final HttpMate useCaseDrivenHttpMate = HttpMate.anHttpMateConfiguredAs(UseCaseDrivenBuilder.USE_CASE_DRIVEN).post("/api/sendEmail", SendEmailUseCase.class).mappingRequestsAndResponsesUsing(mapMate()...).build();

第一部分是不言自明的：在POST上调用SendEmailUseCase到“ / api / sendEmail”。

还有“ SendEmailUseCase怎么得到一个有效的Email实例？” 聪明的读者可能会问。

确实，这是一个有效的问题，它是此示例中最复杂的技术细节以及魔鬼隐藏的位置。为了使本文的重点放在HttpMate上并使其易于阅读，我们要求另一位同伴与该魔鬼作斗争。我们将在另一篇文章中谈论那个勇敢的伴侣。

默认情况下，HttpMate使用UseCase类的空默认构造函数对其进行初始化。也就是说，通过向构建器添加调用，可以轻松地将HttpMate配置为使用任何依赖项注入机制。以下示例演示了如何使用Google Guice：

final HttpMate useCaseDrivenHttpMate = HttpMate.anHttpMateConfiguredAs(UseCaseDrivenBuilder.USE_CASE_DRIVEN).post("/api/sendEmail", SendEmailUseCase.class).mappingRequestsAndResponsesUsing(mapMate()).configured(toCreateUseCaseInstancesUsing(INJECTOR::getInstance)).build();

查看此github存储库以获取SendEmailUseCase的更详细示例。