Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/myconsciousness/catalog-api
The Catalog API provides an interface to give a common behavior to an Enum, such as searching for a specific Enum element based on the field value set in the Enum, or checking if a specific value is defined in the field of the Enum.
https://github.com/myconsciousness/catalog-api
api bicatalog-interface catalog catalog-api constant enum gradle interface java
Last synced: 14 days ago
JSON representation
The Catalog API provides an interface to give a common behavior to an Enum, such as searching for a specific Enum element based on the field value set in the Enum, or checking if a specific value is defined in the field of the Enum.
- Host: GitHub
- URL: https://github.com/myconsciousness/catalog-api
- Owner: myConsciousness
- License: apache-2.0
- Created: 2020-08-24T04:32:29.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2021-06-05T15:57:38.000Z (over 3 years ago)
- Last Synced: 2024-10-19T07:53:45.042Z (4 months ago)
- Topics: api, bicatalog-interface, catalog, catalog-api, constant, enum, gradle, interface, java
- Language: Java
- Homepage: https://myconsciousness.github.io/catalog-api/org/thinkit/api/catalog/package-summary.html
- Size: 834 KB
- Stars: 7
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Security: SECURITY.md
Awesome Lists containing this project
README
# 1. Catalog API
**Table of Contents**
- [1.1. What is it?](#11-what-is-it)
- [1.2. Benefits](#12-benefits)
- [1.3. How To Use](#13-how-to-use)
- [1.3.1. Add the dependencies](#131-add-the-dependencies)
- [1.3.2. Select interface you want to use](#132-select-interface-you-want-to-use)
- [1.3.3. Import and implement Enum with Catalog / BiCatalog interface](#133-import-and-implement-enum-with-catalog--bicatalog-interface)
- [1.4. License](#14-license)
- [1.5. More Information](#15-more-information)
## 1.1. What is it?
**_Make easier to maintain and use constants!_**
This is a Java-based API designed to make the constants group more maintainable and extensible.
It manages regularized constants as a single `catalog` and provides a convenient utility interface to manipulate the `catalog`.
## 1.2. Benefits
- It assumes the use of `Enum`
- Necessary processes for constant operation are integrated in the interface
- Useful common behaviors can be used anywhere
- No need to use `public static final` constant classes anymore
- **_Easy to maintain and use constants!_**
## 1.3. How To Use
### 1.3.1. Add the dependencies
> **_Note:_**
> Replace version you want to use. Check the latest [Packages](https://github.com/myConsciousness/catalog-api/packages).
> Please contact me for a token to download the package.
**_Maven_**
```xml
org.thinkit.api.catalog
catalog-api
v1.0.3
github
myConsciousness
xxxxxxxxxxxxxxxxxx
```
**_Gradle_**
```gradle
repositories {
maven {
name = "GitHubPackages"
url = uri("https://maven.pkg.github.com/myConsciousness/catalog-api")
credentials {
username = "myConsciousness"
password = "xxxxxxxxxxxxxxxxxx"
}
}
}
dependencies {
implementation 'org.thinkit.api.catalog:catalog-api:v1.0.3'
}
```
### 1.3.2. Select interface you want to use
The `Catalog API` currently provides the following interfaces.
Choose the interface you want to use depending on your needs.
| Interface | Overview |
| --------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **_Catalog>_** | This is the basic catalog interface.
Elements of the concrete catalog class that implement this interface have a `code value`.
You can use the common behavior defined in the Catalog interface. |
| **_BiCatalog, T>_** | Each element of a concrete catalog class that implements this interface can have a `code value` plus a `value of any data type`.
The arbitrary data type is defined at the time of implementation of the concrete catalog class.
You can use the common behavior of the interface. |
### 1.3.3. Import and implement Enum with Catalog / BiCatalog interface
**_Catalog>_**
```java
import org.thinkit.api.catalog.Catalog;
/**
* Because the catalog applies the mechanism of recursive generics,
* specify own type to the generics when implement the Catalog interface.
*/
public enum TestCatalog implements Catalog {
/**
* Catalog constants need unique code value as an parameter
*/
TEST(0);
/**
* Required code value
*/
private int code;
/**
* Simple constructor
*/
TestCatalog(int code) {
this.code ＝ code;
}
@Override
public int getCode() {
return this.code;
}
}
```
**_BiCatalog, T>_**
```java
import org.thinkit.api.catalog.BiCatalog;
/**
* Because the catalog applies the mechanism of recursive generics,
* specify own type to the generics when implement the BiCatalog interface.
*/
public enum TestBiCatalog implements BiCatalog {
/**
* BiCatalog constants need unique code value and any tag value as parameters
*/
TEST(0, "test");
/**
* Required code value
*/
private int code;
/**
* Required tag value.
* The data type of the tag is the data type specified to generics when implement BiCatalog interface.
*/
private String tag;
/**
* Simple constructor
*/
TestCatalog(int code, String tag) {
this.code ＝ code;
this.tag ＝ tag;
}
@Override
public int getCode() {
return this.code;
}
@Override
public String getTag() {
return this.tag;
}
}
```
## 1.4. License
```
Copyright 2020 Kato Shinya.
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License
is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
or implied. See the License for the specific language governing permissions and limitations under
the License.
```
## 1.5. More Information
`Catalog API` was designed and implemented by Kato Shinya, who works as a freelance developer.
Regardless of the means or content of communication, I would love to hear from you if you have any questions or concerns. I do not check my email box very often so a response may be delayed, anyway thank you for your interest!
- [Creator Profile](https://github.com/myConsciousness)
- [Creator Website](https://myconsciousness.github.io)
- [License](https://github.com/myConsciousness/catalog-api/blob/master/LICENSE)
- [Release Note](https://github.com/myConsciousness/catalog-api/releases)
- [Package](https://github.com/myConsciousness/catalog-api/packages)
- [File a Bug](https://github.com/myConsciousness/catalog-api/issues)
- [Reference](https://myconsciousness.github.io/catalog-api/org/thinkit/api/catalog/package-summary.html)