holon core
5.7.0
Последний релиз: 5.7.0
Это основной модуль платформы Holon и представляет основу платформы, предоставляя определение общей архитектуры, базовых структур и API.
Основные модуль:
Context ресурсыProperty и API DatastoreJWT )Смотрите документацию модуля для деталей.
Как и любой другой модуль платформы, этот артефакт является частью экосистемы платформы Holon, но также может использоваться в качестве автономной библиотеки.
Смотрите начало работы и документацию на платформе для получения дополнительной информации.
Определение модели свойства:
public interface Subject {
static NumericProperty < Long > ID = NumericProperty . longType ( "id" );
static StringProperty NAME = StringProperty . create ( "name" );
static StringProperty SURNAME = StringProperty . create ( "surname" );
static TemporalProperty < LocalDate > BIRTH = TemporalProperty . localDate ( "birth" );
static BooleanProperty ACTIVE = BooleanProperty . create ( "active" );
static VirtualProperty < String > FULL_NAME = VirtualProperty . create ( String . class ,
propertyBox -> propertyBox . getValue ( NAME ) + " " + propertyBox . getValue ( SURNAME ));
static PropertySet <?> SUBJECT = PropertySet . of ( ID , NAME , SURNAME , BIRTH , ACTIVE , FULL_NAME );
}Конфигурация свойства:
static StringProperty NAME = StringProperty . create ( "name" ). message ( "Name" ). messageCode ( "localization.name" )
. withConfiguration ( "my-config" , "my-value" );Конвертер стоимости свойства:
static StringProperty INTEGER_MODEL = StringProperty . create ( "integer_value" ). converter ( Integer . class ,
integer -> String . valueOf ( integer ), string -> Integer . valueOf ( string ));Validators Property:
static StringProperty NAME = StringProperty . create ( "name" )
. withValidator ( Validator . notBlank ()). withValidator ( Validator . max ( 50 ));Докладчики и визуализации недвижимости:
String value = NAME . present ( "A value" );
MyType myType = NAME . render ( MyType . class );Propertybox:
PropertyBox propertyBox = PropertyBox . create ( SUBJECT );
String name = propertyBox . getValue ( NAME );
Optional < String > oname = propertyBox . getValueIfPresent ( NAME );
propertyBox . setValue ( NAME , "John" );
propertyBox . propertyValues (). forEach ( propertyValue -> {
Property <?> property = propertyValue . getProperty ();
Object value = propertyValue . getValue ();
});Datastore:
DataTarget <?> TARGET = DataTarget . named ( "subjects" );
Datastore datastore = getDatastore ();
Stream < PropertyBox > results = datastore . query (). target ( TARGET )
. filter ( NAME . contains ( "a" ). and ( SURNAME . isNotNull ())). sort ( BIRTH . desc ()). stream ( SUBJECT );
Stream < String > names = datastore . query ( TARGET ). aggregate ( SURNAME ). stream ( NAME . max ());
Optional < String > name = datastore . query ( TARGET ). filter ( ID . eq ( 1L )). findOne ( NAME );
datastore . insert ( TARGET , PropertyBox . builder ( SUBJECT ). set ( ID , 1L ). set ( NAME , "John" ). set ( ACTIVE , true ). build ());
datastore . bulkUpdate ( TARGET ). set ( ACTIVE , true ). filter ( BIRTH . lt ( LocalDate . now ())). execute ();
datastore . query ( TARGET ). filter ( ID . eq ( 1L )). findOne ( SUBJECT ). ifPresent ( subject -> datastore . delete ( TARGET , subject ));Собственный комплекс и данные о собственности:
class MyBean {
private @ NotNull Long id ;
private @ Caption ( "The name" ) String name ;
private @ Caption ( "The surname" ) String surname ;
/* getters and setters omitted */
}
BeanPropertySet < MyBean > propertySet = BeanPropertySet . create ( MyBean . class );
PathProperty <?> name = propertySet . property ( "name" );
PathProperty < String > typedName = propertySet . property ( "name" , String . class );
BeanDatastore datastore = BeanDatastore . of ( getDatastore ());
Stream < MyBean > results = datastore . query ( MyBean . class ). filter ( propertySet . property ( "name" ). eq ( "John" )). stream ();
datastore . save ( new MyBean ());Область:
Realm realm = Realm . builder (). withAuthenticator ( Authenticator . create ( MyAuthenticationToken . class , token -> {
if ( "test" . equals ( token . getPrincipal ())) {
return Authentication . builder ( "test" ). withPermission ( "ROLE1" ). build ();
}
throw new UnknownAccountException ();
}))
. withDefaultAuthorizer (). build ();
Realm . builder (). withAuthenticator ( Account . authenticator ( id -> Optional . of ( Account . builder ( id ). build ()))). build ();AuthContext:
AuthContext context = AuthContext . create ( realm );
context . authenticate ( AuthenticationToken . accountCredentials ( "test" , "pwd" ));
Optional < Authentication > authentication = context . getAuthentication ();
boolean permitted = context . isPermitted ( "ROLE1" , "ROLE2" );RestClient:
RestClient client = RestClient . forTarget ( "https://rest.api.example" );
ResponseEntity < TestData > response = client . request ()
. path ( "test/{id}" ). resolve ( "id" , 123 )
. accept ( MediaType . APPLICATION_JSON )
. header ( "MY_HEADER" , "my-value" )
. authorizationBearer ( "An389fz56xsr7" )
. get ( TestData . class );
HttpStatus status = response . getStatus ();
Optional < TestData > payload = response . getPayload ();
Optional < TestData > data = client . request (). path ( "test/{id}" ). resolve ( "id" , 123 )
. getForEntity ( TestData . class );
List < TestData > results = client . request (). path ( "test" ). getAsList ( TestData . class );
client . request (). path ( "test" ). post ( RequestEntity . json ( new TestData ()));
Optional < PropertyBox > propertyBox = client . request (). path ( "test2" )
. propertySet ( PROPERTIES ). getForEntity ( PropertyBox . class ); Локализация Context:
LocalizationContext localizationContext = LocalizationContext . builder ()
. withMessageProvider ( MessageProvider . fromProperties ( "messages" ). build ())
. withDefaultDateTemporalFormat ( TemporalFormat . MEDIUM )
. withInitialLocale ( Locale . US )
. build ();
localizationContext . localize ( Locale . ITALY );
String localized = localizationContext . getMessage ( "message.code" , "Default message" );
String formatted = localizationContext . format ( LocalDate . now ());
formatted = localizationContext . format ( 123.4d );
Optional < LocalizationContext > current = LocalizationContext . getCurrent ();См. Документацию модуля для руководства пользователя и полный набор примеров.
См. Структура и конвенции кода платформы Holon, чтобы узнать о философии «Real Java API», с которой разрабатывается и организованная кодовая база проекта.
Платформа Holon построена с использованием Java 11 , поэтому вам нужна JRE/JDK версия 11 или выше, чтобы использовать артефакты платформы.
Смотрите выпуски для доступных выпусков. Каждый тег выпуска предоставляет ссылку на закрытые проблемы.
Платформа Holon имеет открытый исходный код и лицензирована по лицензии Apache 2.0. Все артефакты (включая двоичные файлы, источники и Javadocs) доступны в центральном репозитории Maven.
Идентификатор группы Maven для этого модуля является com.holon-platform.core , а для получения артефактов модуля предоставлена и BOM (Билль о материалах) :
Maven Bom:
< dependencyManagement >
< dependency >
< groupId >com.holon-platform.core</ groupId >
< artifactId >holon-bom</ artifactId >
< version >5.7.0</ version >
< type >pom</ type >
< scope >import</ scope >
</ dependency >
</ dependencyManagement >См. Список артефактов для списка доступных артефактов этого модуля.
Платформа Holon предоставляет общий Maven Bom (Sill of Materials) , чтобы легко получить все доступные артефакты платформы:
Платформа Maven Bom:
< dependencyManagement >
< dependency >
< groupId >com.holon-platform</ groupId >
< artifactId >bom</ artifactId >
< version >${platform-version}</ version >
< type >pom</ type >
< scope >import</ scope >
</ dependency >
</ dependencyManagement >См. Список артефактов для списка доступных артефактов этого модуля.
Вы можете создать источники, используя Maven (версия 3.3.x или выше).
mvn clean install
Проверьте документацию платформы или конкретную документацию модуля.
Задайте вопрос о переполнении стека. Мы отслеживаем тег holon-platform .
Сообщить о проблеме.
Коммерческая поддержка также доступна.
См. Репозиторий платформы Холона для набора примеров проектов.
См. Вклад в платформу Холона.
Присоединяйтесь к комнате внесите джактер для любого вопроса и обратитесь к нам.
Все модули платформы Holon являются программным обеспечением с открытым исходным кодом, выпущенным по лицензии Apache 2.0.
Maven Group ID : com.holon-platform.core
| Идентификатор артефакта | Описание |
|---|---|
holon-core | Компоненты, сервисы и API платформы платформы |
holon-http | HTTP сообщений Поддержка |
holon-async-http | Асинхронные HTTP -сообщения |
holon-async-datastore | Асинхронное API данных |
holon-auth | Аутентификация и разрешение |
holon-auth-jwt | Поддержка JSON Web Tokens |
holon-spring | Весенняя интеграция |
holon-spring-security | Весенняя интеграция безопасности |
holon-spring-boot | Интеграция весенней загрузки |
holon-starter | Стартер базового весеннего ботинка |
holon-starter-security | Базовый весенний ботинок с интеграцией Spring Security |
holon-starter-test | Базовый весенний ботинок для модульных тестов |
holon-bom | Билл материалов |
holon-bom-platform | Билл материалов, включая внешние зависимости |
documentation-core | Документация |
