🚗 👨🏻‍⚖️ ☮️ (स्प्रिंग) राज्य (स्प्रिंग) शेल में: एकल उत्पादन नहीं 🌽 👨🏿‍💻 🧑🏿‍🤝‍🧑🏿

अरे, एक ऑटो-पूर्ण इंटरेक्टिव शेल के बारे में क्या, मदद, और अधिक? और मुसीबतों के बिना, और जेवीएम पर भी?

पोस्टमैन मेरे लिए काम का सिरदर्द बन गया। यद्यपि शब्दों में हम सभी टीडीडी हैं और ककड़ी की लाल बत्ती के माध्यम से हम देखते हैं कि वास्तव में क्या टूट गया है, लेकिन व्यवहार में मुझे पोस्टमैन इंटरफ़ेस में अन्य अनुरोधों को अधिक बार भेजना पड़ा। काम की शुरुआत में, एक प्रमाणीकरण टोकन प्राप्त करना आवश्यक था (निर्माण के लिए एक अनुरोध और सत्यापन के लिए एक अनुरोध, उपयोगकर्ता अलग हैं), और फिर बुकमार्क से डाउनलोड करें, मापदंडों को संपादित करें और अन्य अनुरोध शुरू करें। क्लिक-क्लिक-क्लिक करें। एक अलग क्रम में। मैंने पहले ही cURL के साथ स्क्रिप्ट लिखी थी, और मैंने IDEA में अनुरोध किए - यह सुविधाजनक नहीं है। स्वचालित परीक्षणों पर स्विच करने के लिए एक आदर्श प्रेरक, ये समझने के लिए अनुरोध थे कि सेवा की स्थिति, इसके संस्करण, इसके पीछे मेनफ्रेम, घर में मौसम, और निश्चित रूप से प्रतिगमन परीक्षण के अंतर्गत नहीं आया था। क्लिक-क्लिक ने बहुत अधिक समय खाना शुरू कर दिया और माउस का माइलेज बढ़ा दिया।

Spring Shell, shell , Spring. , . , — . — shell, . , — Spring State Machine. , — , — , , Kotlin, Akka "" . State Machine , .

Spring Initializr Gradle Kotlin. .

curl 'https://start.spring.io/starter.zip?type=gradle-project&language=kotlin&bootVersion=2.2.6.RELEASE&baseDir=shell-state&groupId=me.votez.spring&artifactId=shell-state&name=shell-state&description=Demo%20project%20for%20Spring%20State%20Machine%20and%20Shell&packageName=me.votez.spring.shellstate&packaging=jar&javaVersion=1.8' --compressed --output shellstate.zip && unzip shellstate.zip

Spring Shell gradle

    implementation("org.springframework.shell:spring-shell-starter:2.0.0.RELEASE")

(shell). , ShellComponent ( ) , ShellMethod , . , ShellOption. , Bean Validation. , Enum ( , help).

— . — , , actuator .…
( runBlocking — )

package me.votez.spring.shellstate

import org.springframework.shell.standard.ShellComponent
import org.springframework.shell.standard.ShellMethod
import org.springframework.shell.standard.ShellOption
import kotlinx.coroutines.*
import org.springframework.shell.standard.ShellMethodAvailability
import java.util.*
import kotlin.random.Random

@ShellComponent
class ServerCommands {
    private var token: String? = null

    @ShellMethod("Authenticate and obtain token")
    fun login(
           @ShellOption name:String, 
           @ShellOption password:String, 
           @ShellOption(defaultValue = "admin") scope: String) = runBlocking {
            token = UUID.randomUUID().toString()
            delay(2_000)
            "Connected"
        }
    }

    @ShellMethod("List projects regstered on server")
    fun list(
        @ShellOption(defaultValue = "PROJECT", help = "Possible values are PROJECT and USER") type:EntityType) = when(type) {
        EntityType.PROJECT -> listOf("Roga i Kopita", "Svetliy Put", "NIICHAVO")
        EntityType.USER -> listOf( "Ivanov", "Petrov", "Sidorov")
    }
}

enum class EntityType {
    PROJECT,
    USER
}

. IntelliJ IDEA, Spring Shell JLine, Linux, MacOS Windows, IDE — .

$ bash ./gradlew build
$ java -jar build/libs/shell-state-0.0.1-SNAPSHOT.jar

help, . clear, exit, quit, script, stacktrace.

2020-05-03 12:49:35.442  INFO 23211 --- [           main] m.v.s.s.ShellStateApplicationKt          : Started ShellStateApplicationKt in 1.036 seconds (JVM running for 0.936)
shell:>help
AVAILABLE COMMANDS

Built-In Commands
        clear: Clear the shell screen.
        exit, quit: Exit the shell.
        help: Display help about available commands.
        script: Read and execute commands from a file.
        stacktrace: Display the full stacktrace of the last error.

Server Commands
        list: List projects registered on server
        login: Authenticate and obtain token

shell:>help list

NAME
        list - List projects registered on server

SYNOPSYS
        list [[--type] entity-type]  

OPTIONS
        --type  entity-type
                Possible values are PROJECT and USER
                [Optional, default = PROJECT]

. login list L, . l TAB , o TAB, login. . , > login root 123456 , — Connected. list .

list , list . :


    @ShellMethodAvailability("list")
    fun listAvailable() = if (token != null) Availability.available()  else Availability.unavailable("cannot run without auth token")

shell, , . help , .

2020-05-02 13:30:12.593  INFO 4443 --- [           main] m.v.s.s.ShellStateApplicationKt          : Started ShellStateApplicationKt in 1.525 seconds (JVM running for 1.252)
shell:>list
Command 'list' exists but is not currently available because cannot run without auth token
Details of the error have been omitted. You can use the stacktrace command to print the full stacktrace.
shell:>help
AVAILABLE COMMANDS

Built-In Commands
        clear: Clear the shell screen.
        exit, quit: Exit the shell.
        help: Display help about available commands.
        script: Read and execute commands from a file.
        stacktrace: Display the full stacktrace of the last error.

Server Commands
      * list: List projects regstered on server
        login: Authenticate and obtain token

Commands marked with (*) are currently unavailable.
Type `help <command>` to learn more.

shell:>help list

NAME
        list - List projects registered on server

SYNOPSYS
        list [[--type] entity-type]  

OPTIONS
        --type  entity-type
                Possible values are PROJECT and USER
                [Optional, default = PROJECT]

CURRENTLY UNAVAILABLE
        This command is currently not available because cannot run without auth token.

, . , , , . command prompt, . , application.properties — , Spring Framework ( ). prompt , .

PrompProvider, , JLine.

@ConfigurationProperties(prefix="shell")
class ServerCommands : PromptProvider

    lateinit var env: String //   application.properties

    override fun getPrompt(): AttributedString =
            AttributedString("${env}:>",
                    AttributedStyle.DEFAULT.foreground(
                            if (token == null) AttributedStyle.YELLOW else AttributedStyle.GREEN))

, . .

, , (soap, protobuf ) — , - . , .

Spring State Machine

, . . , , , . , … , .

Spring State Machine.

, (), -. — The Evolution of Trust. , () . xml — , - .

, . , "" . Spring State Machine , , .

, . , . — Spring SM , . " ", - , - , , — .

, , . - — , .

?

, .

, "" . . ( ) , Thread Pool, shell, SSM - — .

command prompt " ", .

, . Quick Start.

, — . — command prompt. , , — , token. null-safe lateinit.
.

override fun configure(transitions: StateMachineTransitionConfigurer<State, Event>) {
        transitions
                .withExternal()
                .source(State.INIT).target(State.CONNECTING)
                .event(Event.LOGIN)
                .and()
                .withExternal()
                .source(State.CONNECTING).target(State.READY).event(Event.CONNECTED)
                .action { context -> context.extendedState.variables["token"] = context.messageHeaders["token"] }.and()
                .withExternal()
                .source(State.CONNECTING).target(State.INIT).event(Event.FAILED).and()
                .withInternal()
                .source(State.READY).event(Event.COMMAND).and()
                .withExternal()
                .source(State.READY).target(State.CONNECTING).event(Event.LOGIN)
    }

....
enum class State {    INIT, CONNECTING, READY }
enum class Event {  LOGIN, CONNECTED, FAILED, COMMAND }

— , — . Spring. , , . .

. login:

    @Autowired
    lateinit var stateMachine: StateMachine<State, Event>

   //    null
    lateinit var token: String

    @ShellMethod("Authenticate and obtain token")
    fun login(
            @ShellOption name: String,
            @ShellOption password: String,
            @ShellOption(defaultValue = "admin") scope: String) =
            runBlocking {
                stateMachine.sendEvent(
                        MessageBuilder.createMessage(Event.LOGIN, MessageHeaders(mapOf("login" to name))))
                delay(1_000)
                token = UUID.randomUUID().toString()
                stateMachine.sendEvent(
                        MessageBuilder.createMessage(Event.CONNECTED, MessageHeaders(mapOf("token" to token))))
                "Connected"
            }
...

command prompt:

    private val colors = mapOf(State.READY to AttributedStyle.DEFAULT.foreground(AttributedStyle.GREEN))
            .withDefault { AttributedStyle.DEFAULT.foreground(AttributedStyle.YELLOW) }

    override fun getPrompt(): AttributedString =
            AttributedString("${env}:>", colors.getValue(stateMachine.state.id))

    @ShellMethodAvailability("list")
    fun listAvailable() =
            if (stateMachine.state.id == State.READY) Availability.available()
            else Availability.unavailable("requires authentication performed first")

Spring State Machine — (guards), , , , , .

स्प्रिंग शैल परियोजना विकास के लिए विशिष्ट उपयोगिताओं के लिए एक उत्कृष्ट समाधान है, जब गैर-तुच्छ कार्यों के आंशिक स्वचालन की आवश्यकता होती है।

स्प्रिंग स्टेट मशीन कई सामुदायिक परियोजनाओं में से एक है जो अधिक ध्यान देने योग्य है और पूर्वाग्रह के बावजूद अप-टू-डेट तकनीक है।

नमूना कोड GitHub पर उपलब्ध है ।

(स्प्रिंग) राज्य (स्प्रिंग) शेल में: एकल उत्पादन नहीं

Spring State Machine

Spring State Machine.

?

More articles: