update readme

This commit is contained in:
Edward 2020-05-03 01:40:25 +08:00
parent 3500e141b7
commit 773d8dc789

102
README.md
View File

@ -11,100 +11,106 @@
A curated collection of idiomatic design & application patterns for Go language. A curated collection of idiomatic design & application patterns for Go language.
+ Merged : https://github.com/nynicg/go-patterns
+ Merged : https://github.com/weichou1229/go-patterns
+ Merged : https://github.com/jianhan/go-patterns
## Creational Patterns ## Creational Patterns
| Pattern | Description | Status | | Pattern | Description | Status |
|:-------:|:----------- |:------:| |:-------:|:----------- |:------:|
| [Abstract Factory](/creational/abstract_factory.md) | Provides an interface for creating families of releated objects | âœ| | [Abstract Factory](/creational/abstract_factory.md) | Provides an interface for creating families of releated objects | |
| [Builder](/creational/builder.md) | Builds a complex object using simple objects | âœ| | [Builder](/creational/builder.md) | Builds a complex object using simple objects | |
| [Factory Method](/creational/factory.md) | Defers instantiation of an object to a specialized function for creating instances | âœ| | [Factory Method](/creational/factory.md) | Defers instantiation of an object to a specialized function for creating instances | |
| [Object Pool](/creational/object-pool.md) | Instantiates and maintains a group of objects instances of the same type | âœ| | [Object Pool](/creational/object-pool.md) | Instantiates and maintains a group of objects instances of the same type | |
| [Singleton](/creational/singleton.md) | Restricts instantiation of a type to one object | âœ| | [Singleton](/creational/singleton.md) | Restricts instantiation of a type to one object | |
## Structural Patterns ## Structural Patterns
| Pattern | Description | Status | | Pattern | Description | Status |
|:-------:|:----------- |:------:| |:-------:|:----------- |:------:|
| [Bridge](/structural/bridge/main.go) | Decouples an interface from its implementation so that the two can vary independently | âœ| | [Bridge](/structural/bridge/main.go) | Decouples an interface from its implementation so that the two can vary independently | |
| [Composite](/structural/composite/main.go) | Encapsulates and provides access to a number of different objects | âœ| | [Composite](/structural/composite/main.go) | Encapsulates and provides access to a number of different objects | |
| [Decorator](/structural/decorator.md) | Adds behavior to an object, statically or dynamically | âœ| | [Decorator](/structural/decorator.md) | Adds behavior to an object, statically or dynamically | |
| [Facade](/structural/facade/main.go) | Uses one type as an API to a number of others | âœ| | [Facade](/structural/facade/main.go) | Uses one type as an API to a number of others | |
| [Flyweight](/structural/flyweight/main.go) | Reuses existing instances of objects with similar/identical state to minimize resource usage | âœ| | [Flyweight](/structural/flyweight/main.go) | Reuses existing instances of objects with similar/identical state to minimize resource usage | |
| [Proxy](/structural/proxy.md) | Provides a surrogate for an object to control it's actions | âœ| | [Proxy](/structural/proxy.md) | Provides a surrogate for an object to control it's actions | |
## Behavioral Patterns ## Behavioral Patterns
| Pattern | Description | Status | | Pattern | Description | Status |
|:-------:|:----------- |:------:| |:-------:|:----------- |:------:|
| [Chain of Responsibility](/behavioral/chain_of_responsibility/main.go) | Avoids coupling a sender to receiver by giving more than object a chance to handle the request | âœ| | [Chain of Responsibility](/behavioral/chain_of_responsibility/main.go) | Avoids coupling a sender to receiver by giving more than object a chance to handle the request | |
| [Command](/behavioral/command/main.go) | Bundles a command and arguments to call later | âœ| | [Command](/behavioral/command/main.go) | Bundles a command and arguments to call later | |
| [Mediator](/behavioral/mediator/main.go) | Connects objects and acts as a proxy | âœ| | [Mediator](/behavioral/mediator/main.go) | Connects objects and acts as a proxy | |
| [Memento](/behavioral/memento/main.go) | Generate an opaque token that can be used to go back to a previous state | âœ| | [Memento](/behavioral/memento/main.go) | Generate an opaque token that can be used to go back to a previous state | |
| [Observer](/behavioral/observer.md) | Provide a callback for notification of events/changes to data | âœ| | [Observer](/behavioral/observer.md) | Provide a callback for notification of events/changes to data | |
| [Registry](/behavioral/registry.md) | Keep track of all subclasses of a given class | âœ| | [Registry](/behavioral/registry.md) | Keep track of all subclasses of a given class | |
| [State](/behavioral/state/main.go) | Encapsulates varying behavior for the same object based on its internal state | âœ| | [State](/behavioral/state/main.go) | Encapsulates varying behavior for the same object based on its internal state | |
| [Strategy](/behavioral/strategy.md) | Enables an algorithm's behavior to be selected at runtime | âœ| | [Strategy](/behavioral/strategy.md) | Enables an algorithm's behavior to be selected at runtime | |
| [Template](/behavioral/template/main.go) | Defines a skeleton class which defers some methods to subclasses | âœ| | [Template](/behavioral/template/main.go) | Defines a skeleton class which defers some methods to subclasses | |
| [Visitor](/behavioral/visitor/main.go) | Separates an algorithm from an object on which it operates | âœ| | [Visitor](/behavioral/visitor/main.go) | Separates an algorithm from an object on which it operates | |
## Synchronization Patterns ## Synchronization Patterns
| Pattern | Description | Status | | Pattern | Description | Status |
|:-------:|:----------- |:------:| |:-------:|:----------- |:------:|
| [Condition Variable](/synchronization/condition_variable.md) | Provides a mechanism for threads to temporarily give up access in order to wait for some condition | âœ| | [Condition Variable](/synchronization/condition_variable.md) | Provides a mechanism for threads to temporarily give up access in order to wait for some condition | |
| [Lock/Mutex](/synchronization/mutex.md) | Enforces mutual exclusion limit on a resource to gain exclusive access | âœ| | [Lock/Mutex](/synchronization/mutex.md) | Enforces mutual exclusion limit on a resource to gain exclusive access | |
| [Monitor](/synchronization/monitor.md) | Combination of mutex and condition variable patterns | âœ| | [Monitor](/synchronization/monitor.md) | Combination of mutex and condition variable patterns | |
| [Read-Write Lock](/synchronization/read_write_lock.md) | Allows parallel read access, but only exclusive access on write operations to a resource | âœ| | [Read-Write Lock](/synchronization/read_write_lock.md) | Allows parallel read access, but only exclusive access on write operations to a resource | |
| [Semaphore](/synchronization/semaphore.md) | Allows controlling access to a common resource | âœ| | [Semaphore](/synchronization/semaphore.md) | Allows controlling access to a common resource | |
## Concurrency Patterns ## Concurrency Patterns
| Pattern | Description | Status | | Pattern | Description | Status |
|:-------:|:----------- |:------:| |:-------:|:----------- |:------:|
| [N-Barrier](/concurrency/n_barrier/main.go) | Prevents a process from proceeding until all N processes reach to the barrier | âœ| | [N-Barrier](/concurrency/n_barrier/main.go) | Prevents a process from proceeding until all N processes reach to the barrier | |
| [Bounded Parallelism](/concurrency/bounded/bounded_parallelism.md) | Completes large number of independent tasks with resource limits | âœ| | [Bounded Parallelism](/concurrency/bounded_parallelism.md) | Completes large number of independent tasks with resource limits | |
| [Broadcast](/concurrency/broadcast.md) | Transfers a message to all recipients simultaneously | âœ| | [Broadcast](/concurrency/broadcast.md) | Transfers a message to all recipients simultaneously | |
| [Coroutines](/concurrency/coroutine.md) | Subroutines that allow suspending and resuming execution at certain locations | âœ| | [Coroutines](/concurrency/coroutine.md) | Subroutines that allow suspending and resuming execution at certain locations | |
| [Generators](/concurrency/generator.md) | Yields a sequence of values one at a time | âœ| | [Generators](/concurrency/generator.md) | Yields a sequence of values one at a time | |
| [Reactor](/concurrency/reactor.md) | Demultiplexes service requests delivered concurrently to a service handler and dispatches them syncronously to the associated request handlers | âœ| | [Reactor](/concurrency/reactor.md) | Demultiplexes service requests delivered concurrently to a service handler and dispatches them syncronously to the associated request handlers | |
| [Parallelism](/concurrency/parallelism.md) | Completes large number of independent tasks | âœ| | [Parallelism](/concurrency/parallelism.md) | Completes large number of independent tasks | |
| [Producer Consumer](/concurrency/producer_consumer.md) | Separates tasks from task executions | âœ| | [Producer Consumer](/concurrency/producer_consumer.md) | Separates tasks from task executions | |
## Messaging Patterns ## Messaging Patterns
| Pattern | Description | Status | | Pattern | Description | Status |
|:-------:|:----------- |:------:| |:-------:|:----------- |:------:|
| [Fan-In](/messaging/fan_in.md) | Funnels tasks to a work sink (e.g. server) | âœ| | [Fan-In](/messaging/fan_in.md) | Funnels tasks to a work sink (e.g. server) | |
| [Fan-Out](/messaging/fan_out.md) | Distributes tasks among workers (e.g. producer) | âœ| | [Fan-Out](/messaging/fan_out.md) | Distributes tasks among workers (e.g. producer) | |
| [Futures & Promises](/messaging/futures_promises.md) | Acts as a place-holder of a result that is initially unknown for synchronization purposes | âœ| | [Futures & Promises](/messaging/futures_promises.md) | Acts as a place-holder of a result that is initially unknown for synchronization purposes | |
| [Publish/Subscribe](/messaging/publish_subscribe.md) | Passes information to a collection of recipients who subscribed to a topic | âœ| | [Publish/Subscribe](/messaging/publish_subscribe.md) | Passes information to a collection of recipients who subscribed to a topic | |
| [Push & Pull](/messaging/push_pull.md) | Distributes messages to multiple workers, arranged in a pipeline | âœ| | [Push & Pull](/messaging/push_pull.md) | Distributes messages to multiple workers, arranged in a pipeline | |
## Stability Patterns ## Stability Patterns
| Pattern | Description | Status | | Pattern | Description | Status |
|:-------:|:----------- |:------:| |:-------:|:----------- |:------:|
| [Bulkheads](/stability/bulkhead.md) | Enforces a principle of failure containment (i.e. prevents cascading failures) | âœ| | [Bulkheads](/stability/bulkhead.md) | Enforces a principle of failure containment (i.e. prevents cascading failures) | |
| [Circuit-Breaker](/stability/circuit-breaker.md) | Stops the flow of the requests when requests are likely to fail | âœ| | [Circuit-Breaker](/stability/circuit-breaker.md) | Stops the flow of the requests when requests are likely to fail | |
| [Deadline](/stability/deadline.md) | Allows clients to stop waiting for a response once the probability of response becomes low (e.g. after waiting 10 seconds for a page refresh) | âœ| | [Deadline](/stability/deadline.md) | Allows clients to stop waiting for a response once the probability of response becomes low (e.g. after waiting 10 seconds for a page refresh) | |
| [Fail-Fast](/stability/fail_fast.md) | Checks the availability of required resources at the start of a request and fails if the requirements are not satisfied | âœ| | [Fail-Fast](/stability/fail_fast.md) | Checks the availability of required resources at the start of a request and fails if the requirements are not satisfied | |
| [Handshaking](/stability/handshaking.md) | Asks a component if it can take any more load, if it can't, the request is declined | âœ| | [Handshaking](/stability/handshaking.md) | Asks a component if it can take any more load, if it can't, the request is declined | |
| [Steady-State](/stability/steady_state.md) | For every service that accumulates a resource, some other service must recycle that resource | âœ| | [Steady-State](/stability/steady_state.md) | For every service that accumulates a resource, some other service must recycle that resource | |
## Profiling Patterns ## Profiling Patterns
| Pattern | Description | Status | | Pattern | Description | Status |
|:-------:|:----------- |:------:| |:-------:|:----------- |:------:|
| [Timing Functions](/profiling/timing.md) | Wraps a function and logs the execution | âœ| | [Timing Functions](/profiling/timing.md) | Wraps a function and logs the execution | |
## Idioms ## Idioms
| Pattern | Description | Status | | Pattern | Description | Status |
|:-------:|:----------- |:------:| |:-------:|:----------- |:------:|
| [Functional Options](/idiom/functional-options.md) | Allows creating clean APIs with sane defaults and idiomatic overrides | âœ| | [Functional Options](/idiom/functional-options.md) | Allows creating clean APIs with sane defaults and idiomatic overrides | |
## Anti-Patterns ## Anti-Patterns
| Pattern | Description | Status | | Pattern | Description | Status |
|:-------:|:----------- |:------:| |:-------:|:----------- |:------:|
| [Cascading Failures](/anti-patterns/cascading_failures.md) | A failure in a system of interconnected parts in which the failure of a part causes a domino effect | âœ| | [Cascading Failures](/anti-patterns/cascading_failures.md) | A failure in a system of interconnected parts in which the failure of a part causes a domino effect | |