JavaBaas — это бэкенд-сервисная платформа, разработанная на основе языка Java. Её основная цель — упростить процесс разработки мобильных клиентских приложений и веб-приложений.
Используя инструменты, предоставляемые JavaBaas, можно легко настроить бэкенд. После успешной настройки бэкенда можно использовать RestAPI, iOS/Android-SDK для работы с данными.
Адрес проекта:
Техническая дискуссионная группа: 479167886.
Полный документ доступен по адресу: www.javabaas.com (первоначальный домен был зарегистрирован, но возникла проблема, и в настоящее время он находится в процессе регистрации; временно можно посетить [www.zangyilin.com]).
Docker-способ
JavaBaas предоставляет полную демонстрационную среду Docker (включая базу данных и т. д.), которую необходимо установить после установки Docker.
docker pull javabaas/javabaas-starter
docker run -p 8080:8080 javabaas/javabaas-starter
После успешного выполнения вы можете получить доступ к среде JavaBaas через локальный порт 8080.
Каждый запуск создаёт новую среду выполнения. Если вам нужны постоянные данные, используйте DockerVolume
.
docker run -p 8080:8080 -v /usr/javabaas:/data/db javabaas/javabaas-starter
Здесь /usr/javabaas
— это каталог хранения локальных данных, который вы должны создать или изменить в соответствии с вашими потребностями.
Способ Jar-пакета
Вы также можете запустить JavaBaas, используя jar-пакет.
JDK JavaBaas написан на JDK1.8, поэтому для компиляции и запуска требуется установка среды JDK1.8. Совет: вы можете загрузить последнюю версию JDK на официальном сайте Oracle.
MongoDB JavaBaas использует MongoDB в качестве базы данных, поэтому сначала необходимо правильно установить и запустить MongoDB. Совет: посетите официальный сайт MongoDB, чтобы загрузить последнюю версию MongoDB.
Redis JavaBaas использует Redis в качестве кэша, поэтому сначала необходимо правильно установить и запустить Redis. Совет: посетите официальный сайт Redis, чтобы загрузить последнюю версию Redis.
Запуск
Файл JavaBaas.jar
в каталоге Server является файлом запуска системы. После правильной настройки зависимостей среды выполните следующую команду для запуска системы:
java -jar JavaBaas.jar
Если вы видите следующее сообщение, система успешно запущена.
[main] s.b.c.e.t.TomcatEmbeddedServletContainer : Tomcat started on port(s): 8080 (http)
[main] c.s.b.c.l.ApplicationEventListener : JavaBaasServer started.
[main] c.j.s.c.l.ApplicationEventListener : Key: JavaBaas
[main] c.j.s.c.l.ApplicationEventListener : Timeout: 600000
[main] c.s.b.c.l.ApplicationEventListener : Host:127.0.0.1
[main] c.j.s.c.l.ApplicationEventListener : JavaBaas status at http://127.0.0.1:8080
[main] c.j.s.c.l.ApplicationEventListener : Browse REST API at http://127.0.0.1:8080/explorer.html
[main] com.staryet.baas.Main : Started Main in 2.653 seconds (JVM running for 3.232)
После успешной работы JavaBaas по умолчанию будет прослушивать все запросы пользователей на порту HTTP 8080. Теперь вам нужно использовать командный инструмент JBShell для создания приложения.
Командный инструмент JBShell является дополнением к JavaBaas и позволяет выполнять такие операции, как создание, удаление, изменение и запрос приложений, а также некоторые вспомогательные функции.
JBShell написан на Java и требует установки среды JDK для компиляции и выполнения.
Mac&Linux-установка
В командной строке выполните следующую команду:
curl -s "http://get.javabaas.com/jbshell.sh" | bash
После завершения установки вы увидите следующее сообщение:
Успешно установлен jbshell
Пожалуйста, откройте новое окно терминала или выполните следующие команды в текущем окне:
source "/Users/staryet/.javabaas/jbshell/export/jbexport"
Начните творить!!!
Откройте новое окно или выполните указанную команду в текущем окне, чтобы завершить установку JBShell.
Windows-установка
Запуск
В командной строке используйте следующую команду для запуска инструмента командной строки JBShell:
jb
После успешного запуска появится следующее сообщение:
___ ______
|_ | | ___ \
| | __ _ __ __ __ _ | |_/ / __ _ __ _ ___
| | / _` |\ \ / // _` || ___ \ / _` | / _` |/ __|
/\__/ /| (_| | \ V /| (_| || |_/ /| (_| || (_| |\__ \
\____/ \__,_| \_/ \__,_|\____/ \__,_| \__,_||___/
Версия:1.0.0
Хост:http://localhost:8080/api/
AdminKey:JavaBaas
BAAS>
Создание приложения
На уровне высшего уровня организации в JavaBaas находится приложение. Каждое приложение имеет независимые права доступа, пользователей и данные. Чтобы начать использовать JavaBaas, вам необходимо создать приложение.
Сначала запустите командный инструмент и используйте команду app add Blog
, чтобы создать приложение для блога.
BAAS>app add Blog
Создание приложения успешно завершено
Установите текущее приложение как Blog
Теперь у нас есть приложение с именем Blog
.
Совет: обычно рекомендуется использовать заглавные буквы в начале имени приложения.
Просмотр списка приложений
Используйте команду apps
в командном инструменте, чтобы просмотреть все приложения в JavaBaas.
BAAS>apps
Блог
Сейчас мы видим, что в системе есть только одно приложение, которое мы создали, с именем Блог
.
Переключение текущего приложения
Используйте команду use
в командном инструменте для переключения текущего приложения, после чего вы сможете создавать классы для хранения данных текущего приложения.
BAAS>use Blog
Установить текущее приложение как Блог
Теперь наше приложение переключено на Блог
.
Совет: обычно рекомендуется использовать заглавные буквы для имён классов.
Создать класс
Данные в JavaBaas организованы в виде классов. Пользователи могут свободно создавать классы, имена которых должны начинаться с буквы и содержать только цифры и буквы. После создания класса необходимо создать поля для хранения данных в классе. Кроме того, система автоматически создаст пользовательские классы, классы устройств, классы журналов отправки и системные классы при инициализации системы после установки. Имена системных классов начинаются с символа подчёркивания _
, и их нельзя удалить или изменить.
Теперь мы используем команду class add Article
, чтобы создать класс для хранения информации о статьях в блоге.
Blog>class add Article
Создание класса успешно завершено
Теперь в приложении Blog
у нас есть класс с именем Article
.
Просмотреть список классов
Используйте class
для просмотра всех классов текущего приложения.
Blog>class
_File(0)
_Installation(0)
_PushLog(0)
_User(0)
Article(0)
Мы видим, что текущее приложение содержит системные классы файлов, устройств, журналов отправки и пользователей, а также созданный нами класс Article
для хранения статей.
Переключить текущий класс
После создания класса Article
нам нужно создать поля в этом классе для хранения таких данных, как заголовки статей и авторы. Сначала нам нужно переключить текущий класс на Article
.
Используйте set Article
, чтобы переключить текущий класс на Article
:
Блог>set Article
* * *
Настройка текущего класса на «Article».
Блог Article>
После переключения курсор становится «Blog Article», что означает, что текущее приложение — «Blog», а текущий класс — «Article».
* * *
**Создание полей**
Используя команду field add title, создаём в классе Article поле для хранения заголовка статьи.
Blog Article>field add title Будет предложено выбрать FieldType. По умолчанию STRING. 1 STRING 2 NUMBER 3 BOOLEAN 4 DATE 5 FILE 6 OBJECT 7 ARRAY 8 POINTER 0 取消
1 Создание поля прошло успешно.
Создали поле title типа STRING в классе Article.
* * *
Рекомендуется использовать строчные буквы для имён полей.
**Просмотр списка полей**
С помощью команды fields можно просмотреть список всех полей текущего класса.
Blog Article>fields NUMBER read STRING title
В текущем классе есть два созданных поля.
* * *
**Хранение данных**
После успешного создания класса и добавления полей можно приступать к операциям с данными (включая использование RestAPI и iOS/Android-SDK). Здесь мы используем командную строку для основных операций вставки, изменения, удаления и запроса данных.
**Вставка данных**
Используем команду add для вставки данных в класс Article.
Blog Article>add {"title":"StarWars","read":10} Объект создан.
Мы добавили одну запись в класс Article.
* * *
Все данные в JavaBaas хранятся в формате JSON. Подробнее см. в документации по хранению данных.
**Запрос данных**
Для запроса данных из класса Article используем команду list.
Blog Article>list {"className":"Article", "objectId":"06904d004d2d462b888800abb9d03a8b", "updatedAt":"1509953994688", "createdAt":"1509953994688", "serverData":{"read":10,"title":"StarWars"}}
Сейчас в классе Article только одна добавленная запись.
* * *
**Печать таблицы**
Команда table печатает таблицу со всеми данными из класса Article.
Blog Article>table ┌──────────────────────────────────┬────────────────────┬────────────────────┐ │ id │ read │ title │ │ │ │ │ ├──────────────────────────────────┼────────────────────┼────────────────────┤ │ 06904d004d2d462b888800abb9d03a8b │ 10 │ StarWars │ └──────────────────────────────────┴────────────────────┴────────────────────┘
* * *
**Удаление данных**
Чтобы удалить данные, используем команду del и указываем идентификатор объекта.
Blog Article>del 06904d004d2d462b888800abb9d03a8b Объект удалён.
**Использование RestAPI для тестирования**
Теперь у нас есть работающее приложение, структура данных и некоторые данные. Мы можем использовать клиентский SDK и REST API для доступа к данным.
JavaBaas имеет встроенный инструмент для тестирования RestAPI. После запуска инструмента вы можете получить доступ к нему через браузер по адресу http://127.0.0.1:8080/explorer.html.
Введите AdminKey (по умолчанию JavaBaas) в текстовое поле и нажмите Enter. Затем выберите приложение из выпадающего меню. В нашем случае это Blog.
Вы увидите список классов приложения. Выберите класс Article, чтобы увидеть операции с данными для этого класса (вставка, изменение, удаление и т. д.).
Разверните метод GET и нажмите кнопку «Тест», чтобы отправить запрос на получение данных. Вы увидите результат запроса, который содержит данные, добавленные ранее с помощью командной строки.
Тестовый инструмент показывает полную структуру запроса. Вы можете использовать эту информацию для построения HTTP-запросов.
Добавьте новую запись, используя тестовый инструмент. Выберите метод POST, создайте новую запись в соответствии с форматом данных класса Article и нажмите «Тест». Теперь вы можете запросить данные снова и увидеть две записи в таблице.
**Использование клиентского SDK**
В рабочей среде вы можете использовать клиентский SDK или REST API для работы с данными. Подробные инструкции см. в соответствующих документах.
Вы можете оставить комментарий после Вход в систему
Неприемлемый контент может быть отображен здесь и не будет показан на странице. Вы можете проверить и изменить его с помощью соответствующей функции редактирования.
Если вы подтверждаете, что содержание не содержит непристойной лексики/перенаправления на рекламу/насилия/вульгарной порнографии/нарушений/пиратства/ложного/незначительного или незаконного контента, связанного с национальными законами и предписаниями, вы можете нажать «Отправить» для подачи апелляции, и мы обработаем ее как можно скорее.
Опубликовать ( 0 )