[译]公用SMS消息存储库

原文地址：https://www.codeproject.com/Articles/996504/Public-SMS-Message-Repository

原文作者：Yvan Rodrigues

译文由本站 robot-v1.0 翻译

前言

Store and retrieve messages in a central repository with SMS using Twilio and ASP.NET.

使用Twilio和ASP.NET使用SMS在中央存储库中存储和检索消息.

• 下载RedCell.Web.SmsRepository.zip-188.7 KB(Download RedCell.Web.SmsRepository.zip - 188.7 KB) (包括.chm帮助)((includes .chm help))
• GitHub上的SmsRepository(SmsRepository on GitHub)

介绍(Introduction)

该项目使个人可以使用手机来(This project enables an individual use a mobile phone to)商店(store)短消息"在云中",可以是(a short message “in the cloud”, that can be)已接(picked up)他人使用他们的手机.(by others using their mobile phone.)

该项目将演示如何:(This project will demonstrate how to:)

• 使用Twilio TwiML API响应SMS消息;(use the Twilio TwiML API to respond to SMS messages;)
• 使用XML作为数据存储;(use XML as a data store;)
• 一路上有一些政治乐趣.(have some political fun along the way.)

试试看(免费).(Try it (for free).)

在开始之前,请先看一下应用程序.使用手机,短信(文字)(Before we get started, see the application in action. Using your mobile phone, SMS (text)) bush 至(to) +1 530 PROJECT (如代码中((as in Code)项目(Project),或+15307765328).(, or +15307765328).)

注意:该演示不允许添加/更改/删除消息.(Note: The demo does not allow addition/change/deletion of messages.)

背景(Background)

我的垒球队遇到了问题.如果游戏因下雨或冰雹而取消或改期,则很难将信息迅速传达给所有玩家.他们会开车去球场,只是为了了解取消情况.(My softball team had a problem. If a game was cancelled or rescheduled due to rain (or hail), it was difficult to relay the message to all the players quickly. They would drive to the ball park, only to learn about the cancellation.)

此项目于2012年编写,并针对本文进行了重写,是一个解决方案.它是这样的:(This project, written in 2012, and rewritten for this article, is a solution. It works like this:)

• 队长通过向应用程序发送消息来设置消息:(The team captain sets a message by sending a message to the application:) set rainout bingo July 5 @ 10:00 Today's games are cancelled.
• 该应用程序响应:(The application responds:) rainout set: July 5 @ 10:00 Today's games are cancelled.
• 玩家可以通过将机器发送到应用程序来检查状态:(Players can check the status by sending a machine to the application:) rainout
• 该应用程序响应:(The application responds:) July 5 @ 10:00 Today's games are cancelled.

怎么运行的(How it Works)

特威里奥(Twilio) 是电话网关.它在互联网之间桥接数据和语音,(is a telephony gateway. It bridges data and voice between the internet,) POTS(POTS) 和(, and) 3GPP(3GPP) 网络.通过使用Twilio设置帐户,可以直接向和从分配的号码拨打电话和留言.(networks. By setting up an account with Twilio, calls and messages be be directed to and from an assigned number.)

该项目使用一个简单的API,称为(This project uses a simple API, called) TwiML(TwiML) .它的使用非常简单:(. It’s use is very simple:)

• 通过指定应用程序的URI,电话号码与Web应用程序相关联.(A phone number is associated with a web application by specifying the URI of the application.)
• 当号码收到消息时,将对指定的URI进行HTTP POST,如下所示:(When the number receives a message, an HTTP POST is made to the specified URI as) application/x-www-form-urlencoded ,其中包含数据和元数据.(, containing data and metadata.)
• 应用程序使用XML文档(TwiML)响应请求,其中包含有关如何响应的说明.(The application responds to the request with an XML document (TwiML), containing instructions on how to respond.)
• 响应被中继回请求者.(The response is relayed back to the requestor.)

代码内(Inside the Code)

在此示例中,我使用IIS/ASP.NET充当HTTP服务器和脚本接口.传入请求是通过覆盖(In this example I have used IIS/ASP.NET to act as the HTTP server and scripting interface. Incoming requests are handled by overriding the) Render 的方法(method of the) Default Page 类.如果表单是用POST发布的(class. If a form is POSTed with a) Body 参数,(parameter, the) Controller 被调用.(is invoked.)

控制者(Controller)

有效请求消息的示例包括:(Examples of valid request messages are:)

• bush
• set greeting bingo Thanks for stopping by!
• greeting
• delete greeting bingo ParseTwilioRequest 使用正则表达式将消息拆分成其各个组成部分.(uses a regular expression to split the message into its components.)

// Parse the twilio request.
string command = string.Empty, message = null, password = null, key = null;
var matches = Regex.Match(request, "^(?<command>[^ ]+) (?<key>[^ ]+) (?<password>[^ ]+)(?: (?<message>.*))?$|^(?<command>[^ ]+)(?: (?<values>.*))?$");

可能的消息组件是:(The possible message components are:)

• 命令(command)- 动词/指令.这是唯一的(A verb/instruction. This is the only)**需要(required)**零件.有效命令是任何存储的密钥,(component. Valid commands are any stored key,) hello ,(,) ping ,(,) set ,(,) delete 和(, and) bush .(.)- 密码(password)- 如果执行(If performing a) set 要么(or) delete 命令,一个(command, a) password 是必须的.密码由指定(is required. The password is specified by) Repository.Password. - 键(key)- 如果执行(If performing a) set 要么(or) delete 命令,(command, the) key 键/消息对.密钥必须匹配由(of a key/message pair. The key must match a pattern, specified by) Repository.KeyPattern .(.)- 信息(message)- 如果执行(If performing a) set 要么(or) delete 命令,(command, the) message 键/消息对.(of a key/message pair.)如果不存在任何组件,或者命令无效,则返回默认消息.(If no components are present, or the command is invalid, a default message is returned.)

资料库(Repository)

该应用程序使用XML文件作为数据存储库,由(The application uses and XML file as a data repository, abstracted by the) Repository 类.它子类(class. It subclasses) XDocument ,并提供操作其数据的属性和方法.(, and provides properties and methods to manipulate its data.)

<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<repository password="bingo" pattern="[a-zA-Z0-9]{3,10}">
  <default>Reply with [hello|bush|{0}]. +1530PROJECT brought to you by Red Cell Innovation Inc.</default>
  <message key="foo">bar</message>
  <message key="rainout">July 5 @ 1000 Today's games are cancelled.</message>
</repository>

布什主义(Bushisms)

只是为了好玩,一个布什请求被调用(Just for some fun, a bush request invokes) Bushisms.GetRandom() 随机(for a random)**杜比亚(Dubya)**引用.(quote.)

部署方式(Deployment)

• 将提供的文件复制到您的Web服务器.(Copy the provided files to your web server.)

• 开设一个Twilio帐户(您将获得一些免费积分).(Open a Twilio account (you’ll receive some free credit).)

• 订购电话号码.(Order a telephone number.)

• 在电话号码配置中,将应用程序的URI分配给SMS回调.(In the telephone number configuration, assign the URI of your application the to the SMS callback.)

• 测试并使用Twilio的警报面板进行调试.(Test, and use Twilio’s alerts panel to debug.) 一旦您的信用额度过期,此项目的费用为:(Once your credit expires, this project will cost:)

• 一个电话号码每月约1.00美元;(about USD 1.00 per month for a telephone number;)

• 每条已发送或接收的消息约0.0075美元(¾¢).(about USD 0.0075 (¾¢) per message sent or received.)

安全注意事项(Security Considerations)

就我而言,安全性不是主要问题.记住:(For my use, security was not a major concern. Keep in mind:)

• 用于设置和删除邮件的密码以纯文本格式存储在(The password, used to set and delete messages is stored in plain text in the) repository.xml 文件,消息也是如此.(file, so are the messages.)
• 为了保护应用程序的安全,应在使用SSL/TLS(HTTPS)加密Twilio和Web服务器之间的消息传输的服务器上对其进行配置.(To secure the application, it should be configured on a server that uses SSL/TLS (HTTPS) to encrypt the transport of messages between Twilio and the web server.)
• 通过设计,可以仅使用关键字从商店中检索消息.(By design, messages can be retrieved from the store using only a keyword.)

有助于(Contribute)

您如何使用此应用程序？您还能想象其他哪些用例？在下面添加您的回复.(How could you use this application? What other use cases can you imagine? Add your response below.)

结论(Conclusion)

该项目演示了如何在不使用任何外部库或依赖项的情况下构建简单的SMS应用程序.(This project demonstrates how to build a simple SMS application without the use any external libraries or dependencies.)

我不隶属于Twilio.本文不是Twilio的认可. Twilio是一个电话网关,还有许多其他网关.每个都可能以不同的成本提供不同的服务.(I am not affiliated with Twilio. This article is not an endorsement for Twilio. Twilio is one telephony gateway, and there are many others. Each may offer different services, at different costs.)

注意:(Note:)为本文提供一个有效的演示会带来实际成本.此演示的费用由红细胞创新公司赞助.如果您需要开发电话或移动应用程序,请考虑我们.(Offering a working demo for this article has real costs. The cost of this demonstration is sponsored by Red Cell Innovation Inc. If you require development of a telephony or mobile application, please consider us.)

历史(History)

• 2015年5月31日–首次发布(May 31, 2015 – First publication)

许可

本文以及所有相关的源代码和文件均已获得The Code Project Open License (CPOL)的许可。