OSCHINA-MIRROR/woden-nami

НАМИ: специально для разработки серверной части для небольших программ WeChat

Контейнер для логической структуры, ориентированный на разработчиков серверной части.

Что такое НАМИ?

НАМИ — это фреймворк для серверной стороны небольших программ WeChat. Официально он называется MINA; мы же назвали нашу неофициальную серверную часть НАМИ (нано).

НАМИ предоставляет поддержку для всех сервисов, необходимых небольшим программам WeChat, включая обработку запросов request, приём и обработку websocket, взаимодействие с сервером WeChat и поддержание access_token, аутентификацию при входе в WeChat, отправку шаблонных сообщений, получение уведомлений о платежах WeChat и т. д.

Для небольших приложений: вам нужно только найти компьютер (неважно, Windows, Mac или Linux), облачный виртуальный сервер или даже экземпляр Docker, чтобы установить НАМИ. НАМИ предлагает комплексное решение для серверной части небольших программ, которое берёт на себя все проблемы, связанные с разработкой серверной части.

Что касается больших приложений: возможно, небольшие программы — это лишь часть вашей ИТ-архитектуры. Возможно, вам также придётся рассмотреть балансировку нагрузки, рассмотреть развёртывание нескольких экземпляров и рассмотреть кэширование. НАМИ может служить в качестве чисто Java-фреймворка с открытым исходным кодом, упрощая вашу разработку на Java и помогая вам более эффективно решать проблемы, связанные с небольшими программами.

Более подробное описание (спасибо партнёру по фронтенду за создание страницы): http://riversoft.com.cn/nami.html

Аудитория НАМИ

Разработчики серверной части

Не требуется знание Java, PHP или других языков серверной части; не нужно устанавливать TOMCAT, не нужен LAMP; используйте свой самый знакомый язык программирования JavaScript для написания логики серверной части и используйте командные операторы для непосредственной работы с базой данных и вызова служб WeChat (вы когда-нибудь пробовали отправлять шаблонные сообщения с помощью JavaScript?).

Те, кто сосредоточен на реализации бизнес-логики и не хочет беспокоиться о технических аспектах, разработчики серверной части небольших программ

Возможно, вы опытный разработчик на Java или PHP, но у вас мало времени на разработку небольших программ от лидера; столкнувшись с аутентификацией входа, платежами, шаблонными сообщениями и использованием unionid для подключения к сервисным аккаунтам, глядя на документацию WeChat о токенах доступа и сердцебиении, шифровании и дешифровании, вы можете быть ошеломлены; возможно, вы лучше разбираетесь в моделировании требований и разработке бизнес-логики, но не хотите беспокоиться о технических деталях; НАМИ использует подход к разработке на основе сценариев, и если вы знаете, как писать if (условные выражения) и for-each (циклы), вы сможете быстро и эффективно решить все свои проблемы.

Разработчики на Java

НАМИ разработан исключительно на языке Java и имеет чёткую упаковку и внешний API; в НАМИ встроен динамический движок сценариев, который полностью инкапсулирует официальный API сервера WeChat; НАМИ также может стать одним из ваших независимых пакетов JAR с открытым исходным кодом и помочь вам быстрее и эффективнее решать проблемы.

Особенности НАМИ

Может работать непосредственно на любом основном IAAS, PAAS или контейнере Docker, таком как Alibaba Cloud, Tencent Cloud.
Встроен JDK, встроен Tomcat, поддерживает кроссплатформенность (Windows/Linux/macOS).
Имеет встроенное HTTPS-решение, быстрое бесплатное получение сертификатов и автоматическое постоянное обновление.
Архитектура Java EE, зрелое горизонтальное расширение, поддержка высокодоступных систем с высокой степенью параллелизма, способных поддерживать большие и сверхбольшие системы.
Упрощённый режим разработки на основе скриптов, фокусирующийся на бизнес-логике и не беспокоящийся о технической реализации.
Поддержка JavaScript, Groovy, Java для разработки бизнес-логики на любом языке по вашему выбору.
Инкапсуляция API WeChat, простая реализация сообщений, платежей, аутентификации.

Ключевые модули НАМИ

Простой интерфейс запроса.
Настраиваемый WebSocket.
Встроенный движок сценариев (опциональные языки: Groovy/JavaScript/El).
Полная инкапсуляция API WeChat.
Распакуйте и запустите контейнерный пакет.
Система загрузки и скачивания файлов для небольших программ.
Встроенная система HTTPS.

Пример

Фронтенд инициирует запрос.

//==================NAMI HELLO WORLD begin =================
// Первый вызов небольшой программы NAMI
wx.request({
  url: 'http://localhost:8080/request/hello.js',
  data: {
    a : 'hello',
    b : 2
  },
  complete: function(res) {
    console.log("Вызов завершён");
    console.log(res.data);
  }
})
//==================NAMI HELLO WORLD end =================

После запуска НАМИ создайте скрипт в каталоге запросов.
Ответ переднего конца.

Правила разработки

Управление транзакциями

NAMI использует функциональный подход к разработке, независимо от того, является ли это функцией или запросом, один файл представляет одну функцию (или запрос). NAMI определяет:

Файлы, начинающиеся с execute_, create_, update_, delete_, выполняются в рамках одной транзакции, которая поддерживает вложение.
Файлы, начинающиеся с get_, find_, query_, выполняются только для чтения, то есть операции записи, выполняемые в этой логике, будут автоматически отменены NAMI.
Для других имён предполагается, что каждая операция db exec, save и т.д. автоматически фиксирует транзакцию.

Ресурсы

Загрузка

Скачать версию для запуска (с диска Baidu): http://pan.baidu.com/s/1bJmUtg

Документация

Онлайн-документация: https://hyhcoder.gitbooks.io/namiapi/content/

Серия статей

NAMI здесь! Первая небольшая программа Hello World NAMI! (включая видео)
NAMI здесь! Пять минут, чтобы подключить небольшую программу WeChat к базе данных (включая видео).
Анализ примеров одобрения NAMI: введение (1).
Анализ случаев одобрения NAMI: практика кода (2).

Как упаковать

Используйте Maven для сборки, выполните в корневом каталоге:

mvn clean install

Упакованный результат находится в /package/target/nami-pack-<platform>.zip, platform = nojdk|win32|win64|linux32|linux64

О нас

woden (http://github.com/wodenwang) Основной разработчик BPMT WeChat Rapid Development Platform, публичный аккаунт WeChat: Full Stack Siang Jiang Tou.
borball (http://github.com/borball) Инициатор проекта с открытым исходным кодом WeChat JavaSDK (https://github.com/borball/weixin-sdk).