RESTful API And Swagger Doucument

Сервис facelog предоставляет RESTful Web API.

На основе spring boot сервис facelog упакован в интерфейс RESTful Web API, запущен на независимом порту: 46411.

При запуске facelog по умолчанию запускается этот RESTful сервис. Вывод при запуске показывает, что после запуска 26411 (thrift frame) и 36411 (XHR), наконец, запускается порт 46411.

Если RESTful-сервис не требуется запускать, его можно отключить, изменив системный параметр restful.start=false. Как изменить системный параметр, см. раздел «Изменение системных параметров» в руководстве пользователя facelog «facelog 开发手册».

 .d888                            888                   
d88P"                             888                   
888                               888                   
888888  8888b.   .d8888b  .d88b.  888  .d88b.   .d88b.  
888        "88b d88P"    d8P  Y8b 888 d88""88b d88P"88b 
888    .d888888 888      88888888 888 888  888 888  888 
888    888  888 Y88b.    Y8b.     888 Y88..88P Y88b 888 
888    "Y888888  "Y8888P  "Y8888  888  "Y88P"   "Y88888 
                                                    888 
                                               Y8b d88P 
                                                "Y88P"  

[main][INFO ] (FluentPropertyBeanIntrospector.java:147) Ошибка при создании PropertyDescriptor для public final void org.apache.commons.configuration2.AbstractConfiguration.setProperty(java.lang.String, java.lang.Object)! Игнорирование этого свойства. [main][INFO ] (FluentPropertyBeanIntrospector.java:147) Ошибка при создании PropertyDescriptor для public final void org.apache.commons.configuration2.AbstractConfiguration.setProperty(java.lang.String, java.lang.Object)! Игнорирование этого свойства. [main][INFO ] (SyslogConfig.java:54) syslog.level (системный уровень журнала [OFF, FATAL, ERROR, WARN, INFO, DEBUG, ALL]) = INFO [main][INFO ] (SyslogConfig.java:61) syslog.location (расположение системного журнала) = log/facelog.log [main][INFO ] (JedisPoolLazy.java:271) инициализирован пул jedis (инициализация пула) jedis://:hello@localhost:6379/0 timeout : 2000 ms [main][INFO ] (RedisManagement.java:182) запуск сервера redis (запуск сервера redis) [main][INFO ] (RedisManagement.java:252) запуск веб-сервера redis (запуск веб-сервера redis) webredis запускается на:16379 redis location:redis://:hello@localhost:6379/0 [main][INFO ] (GlobalConfig.java:186) параметры сервера redis: [main][INFO ] (GlobalConfig.java:191) host (имя хоста redis): localhost [main][INFO ] (GlobalConfig.java:194) port (порт redis): 6379 [main][INFO ] (GlobalConfig.java:197) database (база данных redis): 0 [main][INFO ] (GlobalConfig.java:201) password (пароль redis):***** [main][INFO ] (GlobalConfig.java:206) timeout (тайм-аут redis [секунды]): 2000 [main][INFO ] (GlobalConfig.java:210) jedisPoolConfig.maxTotal (максимальное количество потоков пула jedis): 8 [main][INFO ] (GlobalConfig.java:214) расположение redis: J:\Redis-x64-2.8.2402 [main][INFO ] (GlobalConfig.java:219) параметры управления токенами: [main][INFO ] (GlobalConfig.java:220) выполнение проверки устройства токена: false [main][INFO ] (GlobalConfig.java:223) выполнение проверки токена человека: false [main][INFO ] (GlobalConfig.java:226) срок действия токена человека [минуты]: 60 [ConfigUtils:171] Загрузка свойств из файла:/J:/facelog/db/facelog-db-orm/target/classes/conf/database.properties [ConfigUtils:95] Не определена переменная среды 'config_folder' [main][INFO ] (ThriftServerService.java:281) Параметры службы RPC (параметры работы службы): [main][INFO ] (ThriftServerService.java:282) порт: 26411 [main][INFO ] (ThriftServerService.java:283) connectionLimit: 32 [main][INFO ] (ThriftServerService.java:284) workerThreads: 8 [main][INFO ] (ThriftServerService.java:285) idleConnectionTimeout: 60.00s [IFaceLog(T:framed,P:binary) STARTING][INFO ] (NettyServerTransport.java:155) запущен транспорт thrift:26411 (:26411) [IFaceLog(T:framed,P:binary) STARTING][INFO ] (ThriftServerService.java:272) служба IFaceLog (T:framed, P:binary) работает (служба запущена) [main][INFO ] (ThriftServerService.java:281) Параметры службы RPC (параметры работы службы): [main][INFO ] (ThriftServerService.java:282) порт: 36411 [main][INFO ] (ThriftServerService.java:283) connectionLimit: 32 [main][INFO ] (ThriftServerService.java:284) workerThreads: 8 [main][INFO ] (ThriftServerService.java:285) idleConnectionTimeout: 100.00ms [IFaceLog(T:http,P:json) STARTING] NettyServerTransport.java:155 запустил транспорт thrift:36411 (:36411)

[IFaceLog(T:http,P:json) STARTING][INFO ] (ThriftServerService.java:272) IFaceLog(T:http,P:json) сервис запущен (服务启动)
 
  .   ____          _            __ _ _
 /\\ / ___'_ __ _ _(_)_ __  __ _ \ \ \ \
( ( )\___ | '_ | '_| | '_ \/ _` | \ \ \ \
 \\/  ___)| |_)| | | | | || (_| |  ) ) ) )
  '  |____| .__|_| |_|_| |_\__, | / / / /
 =========|_|==============|___/=/_/_/_/
 :: Spring Boot ::        (v1.5.9.RELEASE)

[main][INFO ] (StartupInfoLogger.java:48) Запуск FacelogServiceMain на guyadong-PC с PID 10880 (J:\facelog\facelog-service\target\classes запущен guyadong в J:\facelog\facelog-service)
 [main][INFO ] (SpringApplication.java:593) Активный профиль не установлен, откат к профилям по умолчанию: default
 [main][INFO ] (AbstractApplicationContext.java:583) Обновление org.springframework.boot.context.embedded.AnnotationConfigEmbeddedWebApplicationContext@754eb88d: дата запуска [Fri May 24 14:36:23 CST 2019]; корень иерархии контекста
 [background-preinit][INFO ] (Version.java:30) HV000001: Hibernate Validator 5.3.6.Final
 [main][INFO ] (AutowiredAnnotationBeanPostProcessor.java:155) Обнаружена и поддерживается аннотация JSR-330 'javax.inject.Inject' для автопроводки
 [main][INFO ] (TomcatEmbeddedServletContainer.java:89) Tomcat инициализирован с портами: 8080 (http)
 五月 24, 2019 2:36:25 下午 org.apache.catalina.core.StandardService startInternal
信息: Запуск службы [Tomcat]
五月 24, 2019 2:36:25 下午 org.apache.catalina.core.StandardEngine startInternal
информация: запуск Servlet Engine: Apache Tomcat/8.5.23
五月 24, 2019 2:36:25 下午 org.apache.catalina.core.ApplicationContext log
информация: инициализация Spring embedded WebApplicationContext
[localhost-startStop-1][INFO ] (EmbeddedWebApplicationContext.java:276) Корневой WebApplicationContext: инициализация завершена за 1968 мс
 [main][INFO ] (TomcatEmbeddedServletContainer.java:201) Tomcat запущен на портах: 46411 (http)
 [main][INFO ] (StartupInfoLogger.java:57) Запущен FacelogServiceMain за 12,641 секунды (JVM работает в течение 20,932)
 НАЖМИТЕ «quit» ИЛИ «CTRL-C», чтобы выйти

swagger документ

facelog предоставляет swagger онлайн-документацию и тестовую среду. После запуска RESTful сервиса доступ к http://${your.host}:46411/swagger-ui.html откроет онлайн-документ. Как показано на рисунке ниже.