cacheKeyMethod then
28 | * a method arguments will not be used to build cache key even if they annotated with {@link CacheKey}.
29 | *
30 | * @author dmgcodevil
31 | */
32 | @Target({ElementType.PARAMETER})
33 | @Retention(RetentionPolicy.RUNTIME)
34 | @Documented
35 | public @interface CacheKey {
36 |
37 | /**
38 | * Allows specify name of a certain argument property.
39 | * for example: @CacheKey("id") User user,
40 | * or in case composite property: @CacheKey("profile.name") User user.
41 | * null properties are ignored, i.e. if profile is null
42 | * then result of @CacheKey("profile.name") User user will be empty string.
43 | *
44 | * @return name of an argument property
45 | */
46 | String value() default "";
47 | }
48 |
--------------------------------------------------------------------------------
/hystrix-contrib/hystrix-javanica/src/main/java/com/netflix/hystrix/contrib/javanica/cache/annotation/CacheResult.java:
--------------------------------------------------------------------------------
1 | /**
2 | * Copyright 2015 Netflix, Inc.
3 | *
4 | * Licensed under the Apache License, Version 2.0 (the "License");
5 | * you may not use this file except in compliance with the License.
6 | * You may obtain a copy of the License at
7 | *
8 | * http://www.apache.org/licenses/LICENSE-2.0
9 | *
10 | * Unless required by applicable law or agreed to in writing, software
11 | * distributed under the License is distributed on an "AS IS" BASIS,
12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 | * See the License for the specific language governing permissions and
14 | * limitations under the License.
15 | */
16 | package com.netflix.hystrix.contrib.javanica.cache.annotation;
17 |
18 | import java.lang.annotation.Documented;
19 | import java.lang.annotation.ElementType;
20 | import java.lang.annotation.Retention;
21 | import java.lang.annotation.RetentionPolicy;
22 | import java.lang.annotation.Target;
23 |
24 | /**
25 | * Marks a methods that results should be cached for a Hystrix command.
26 | * This annotation must be used in conjunction with {@link com.netflix.hystrix.contrib.javanica.annotation.HystrixCommand} annotation.
27 | *
28 | * @author dmgcodevil
29 | */
30 | @Target({ElementType.METHOD})
31 | @Retention(RetentionPolicy.RUNTIME)
32 | @Documented
33 | public @interface CacheResult {
34 |
35 | /**
36 | * Method name to be used to get a key for request caching.
37 | * The command and cache key method should be placed in the same class and have same method signature except
38 | * cache key method return type, that should be String.
39 | *
40 | * cacheKeyMethod has higher priority than an arguments of a method, that means what actual arguments
41 | * of a method that annotated with {@link CacheResult} will not be used to generate cache key, instead specified
42 | * cacheKeyMethod fully assigns to itself responsibility for cache key generation.
43 | * By default this returns empty string which means "do not use cache method".
44 | *
45 | * @return method name or empty string
46 | */
47 | String cacheKeyMethod() default "";
48 | }
49 |
--------------------------------------------------------------------------------
/hystrix-contrib/hystrix-javanica/src/main/java/com/netflix/hystrix/contrib/javanica/command/ClosureCommand.java:
--------------------------------------------------------------------------------
1 | /**
2 | * Copyright 2012 Netflix, Inc.
3 | *
4 | * Licensed under the Apache License, Version 2.0 (the "License");
5 | * you may not use this file except in compliance with the License.
6 | * You may obtain a copy of the License at
7 | *
8 | * http://www.apache.org/licenses/LICENSE-2.0
9 | *
10 | * Unless required by applicable law or agreed to in writing, software
11 | * distributed under the License is distributed on an "AS IS" BASIS,
12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 | * See the License for the specific language governing permissions and
14 | * limitations under the License.
15 | */
16 | package com.netflix.hystrix.contrib.javanica.command;
17 |
18 | /**
19 | * This interface is used to perform command logic within an anonymous class and basically used as wrapper for some logic.
20 | *
21 | * @param 28 | *33 | * 34 | */ 35 | public final class HystrixRequestContextRule extends ExternalResource { 36 | private HystrixRequestContext context; 37 | 38 | @Override 39 | protected void before() { 40 | this.context = HystrixRequestContext.initializeContext(); 41 | Hystrix.reset(); 42 | } 43 | 44 | @Override 45 | protected void after() { 46 | if (this.context != null) { 47 | this.context.shutdown(); 48 | this.context = null; 49 | } 50 | } 51 | 52 | public HystrixRequestContext context() { 53 | return this.context; 54 | } 55 | 56 | public void reset() { 57 | after(); 58 | before(); 59 | } 60 | } 61 | -------------------------------------------------------------------------------- /hystrix-contrib/hystrix-junit/src/test/java/com/hystrix/junit/HystrixRequestContextRuleTest.java: -------------------------------------------------------------------------------- 1 | package com.hystrix.junit; 2 | 3 | import org.hamcrest.CoreMatchers; 4 | import org.hamcrest.MatcherAssert; 5 | import org.junit.Rule; 6 | import org.junit.Test; 7 | 8 | public final class HystrixRequestContextRuleTest { 9 | @Rule 10 | public HystrixRequestContextRule request = new HystrixRequestContextRule(); 11 | 12 | @Test 13 | public void initsContext() { 14 | MatcherAssert.assertThat(this.request.context(), CoreMatchers.notNullValue()); 15 | } 16 | 17 | @Test 18 | public void manuallyShutdownContextDontBreak() { 19 | this.request.after(); 20 | this.request.after(); 21 | MatcherAssert.assertThat(this.request.context(), CoreMatchers.nullValue()); 22 | } 23 | } 24 | -------------------------------------------------------------------------------- /hystrix-contrib/hystrix-metrics-event-stream-jaxrs/build.gradle: -------------------------------------------------------------------------------- 1 | dependencies { 2 | api project(':hystrix-core') 3 | implementation project(':hystrix-serialization') 4 | compileOnly 'javax.ws.rs:javax.ws.rs-api:2.0.1' 5 | testImplementation 'junit:junit-dep:4.10' 6 | testImplementation 'org.glassfish.jersey.test-framework.providers:jersey-test-framework-provider-grizzly2:2.25.1' 7 | testImplementation 'org.glassfish.jersey.media:jersey-media-sse:2.25.1' 8 | 9 | } 10 | -------------------------------------------------------------------------------- /hystrix-contrib/hystrix-metrics-event-stream-jaxrs/src/main/java/com/netflix/hystrix/contrib/metrics/HystrixStream.java: -------------------------------------------------------------------------------- 1 | /** 2 | * Copyright 2016 Netflix, Inc. 3 | * 4 | * Licensed under the Apache License, Version 2.0 (the "License"); 5 | * you may not use this file except in compliance with the License. 6 | * You may obtain a copy of the License at 7 | * 8 | * http://www.apache.org/licenses/LICENSE-2.0 9 | * 10 | * Unless required by applicable law or agreed to in writing, software 11 | * distributed under the License is distributed on an "AS IS" BASIS, 12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 | * See the License for the specific language governing permissions and 14 | * limitations under the License. 15 | */ 16 | package com.netflix.hystrix.contrib.metrics; 17 | 18 | import java.util.concurrent.atomic.AtomicInteger; 19 | 20 | import rx.Observable; 21 | 22 | /** 23 | * @author justinjose28 24 | * 25 | */ 26 | public final class HystrixStream { 27 | private final Observable29 | * @Rule 30 | * public HystrixRequestContextRule context = new HystrixRequestContextRule(); 31 | *32 | *
Hystrix: Latency and Fault Tolerance for Distributed Systems
' 25 | } 26 | 27 | jmh { 28 | fork = 10 29 | iterations = 3 30 | jmhVersion = '1.15' 31 | profilers = ['gc'] 32 | threads = 8 33 | warmup = '1s' 34 | warmupBatchSize = 1 35 | warmupIterations = 5 36 | } 37 | -------------------------------------------------------------------------------- /hystrix-core/src/jmh/java/com/netflix/hystrix/perf/CommandConstructionPerfTest.java: -------------------------------------------------------------------------------- 1 | /** 2 | * Copyright 2014 Netflix, Inc. 3 | * 4 | * Licensed under the Apache License, Version 2.0 (the "License"); 5 | * you may not use this file except in compliance with the License. 6 | * You may obtain a copy of the License at 7 | * 8 | * http://www.apache.org/licenses/LICENSE-2.0 9 | * 10 | * Unless required by applicable law or agreed to in writing, software 11 | * distributed under the License is distributed on an "AS IS" BASIS, 12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 | * See the License for the specific language governing permissions and 14 | * limitations under the License. 15 | */ 16 | package com.netflix.hystrix.perf; 17 | 18 | import com.netflix.hystrix.HystrixCommand; 19 | import com.netflix.hystrix.HystrixCommandGroupKey; 20 | import org.openjdk.jmh.annotations.Benchmark; 21 | import org.openjdk.jmh.annotations.BenchmarkMode; 22 | import org.openjdk.jmh.annotations.Mode; 23 | import org.openjdk.jmh.annotations.OutputTimeUnit; 24 | 25 | import java.util.concurrent.TimeUnit; 26 | 27 | public class CommandConstructionPerfTest { 28 | 29 | static HystrixCommandGroupKey groupKey = HystrixCommandGroupKey.Factory.asKey("Group"); 30 | 31 | @Benchmark 32 | @BenchmarkMode({Mode.SingleShotTime}) 33 | @OutputTimeUnit(TimeUnit.MICROSECONDS) 34 | public HystrixCommand constructHystrixCommandByGroupKeyOnly() { 35 | return new HystrixCommand
45 | * The rolling window is defined by {@link HystrixCommandProperties#metricsRollingStatisticalWindowInMilliseconds()}.
46 | *
47 | * @param event
48 | * {@link HystrixRollingNumberEvent} of the event to retrieve a sum for
49 | * @return long rolling count
50 | */
51 | public long getRollingCount(HystrixRollingNumberEvent event) {
52 | return counter.getRollingSum(event);
53 | }
54 |
55 | }
56 |
--------------------------------------------------------------------------------
/hystrix-core/src/main/java/com/netflix/hystrix/collapser/CollapserTimer.java:
--------------------------------------------------------------------------------
1 | /**
2 | * Copyright 2015 Netflix, Inc.
3 | *
4 | * Licensed under the Apache License, Version 2.0 (the "License");
5 | * you may not use this file except in compliance with the License.
6 | * You may obtain a copy of the License at
7 | *
8 | * http://www.apache.org/licenses/LICENSE-2.0
9 | *
10 | * Unless required by applicable law or agreed to in writing, software
11 | * distributed under the License is distributed on an "AS IS" BASIS,
12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 | * See the License for the specific language governing permissions and
14 | * limitations under the License.
15 | */
16 | package com.netflix.hystrix.collapser;
17 |
18 | import java.lang.ref.Reference;
19 |
20 | import com.netflix.hystrix.util.HystrixTimer.TimerListener;
21 |
22 | /**
23 | * Timer used for trigger batch execution.
24 | */
25 | public interface CollapserTimer {
26 |
27 | public Reference
23 | * Unlike all other exceptions thrown by a {@link HystrixCommand} this will not trigger fallback, not count against failure metrics and thus not trigger the circuit breaker.
24 | *
25 | * NOTE: This should only be used when an error is due to user input such as {@link IllegalArgumentException} otherwise it defeats the purpose of fault-tolerance and fallback behavior.
26 | */
27 | public class HystrixBadRequestException extends RuntimeException {
28 |
29 | private static final long serialVersionUID = -8341452103561805856L;
30 |
31 | public HystrixBadRequestException(String message) {
32 | super(message);
33 | }
34 |
35 | public HystrixBadRequestException(String message, Throwable cause) {
36 | super(message, cause);
37 | }
38 | }
39 |
--------------------------------------------------------------------------------
/hystrix-core/src/main/java/com/netflix/hystrix/exception/HystrixTimeoutException.java:
--------------------------------------------------------------------------------
1 | /**
2 | * Copyright 2015 Netflix, Inc.
3 | *
4 | * Licensed under the Apache License, Version 2.0 (the "License");
5 | * you may not use this file except in compliance with the License.
6 | * You may obtain a copy of the License at
7 | *
8 | * http://www.apache.org/licenses/LICENSE-2.0
9 | *
10 | * Unless required by applicable law or agreed to in writing, software
11 | * distributed under the License is distributed on an "AS IS" BASIS,
12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 | * See the License for the specific language governing permissions and
14 | * limitations under the License.
15 | */
16 | package com.netflix.hystrix.exception;
17 |
18 | import com.netflix.hystrix.HystrixCommand;
19 | import com.netflix.hystrix.HystrixObservableCommand;
20 |
21 | /**
22 | * An exception representing an error where the provided execution method took longer than the Hystrix timeout.
23 | *
24 | * Hystrix will trigger an exception of this type if it times out an execution. This class is public, so
25 | * user-defined execution methods ({@link HystrixCommand#run()} / {@link HystrixObservableCommand#construct()) may also
26 | * throw this error. If you want some types of failures to be counted as timeouts, you may wrap those failures in
27 | * a HystrixTimeoutException. See https://github.com/Netflix/Hystrix/issues/920 for more discussion.
28 | */
29 | public class HystrixTimeoutException extends Exception {
30 |
31 | private static final long serialVersionUID = -5085623652043595962L;
32 |
33 | }
34 |
35 |
--------------------------------------------------------------------------------
/hystrix-core/src/main/java/com/netflix/hystrix/exception/package-info.java:
--------------------------------------------------------------------------------
1 | /**
2 | * Copyright 2012 Netflix, Inc.
3 | *
4 | * Licensed under the Apache License, Version 2.0 (the "License");
5 | * you may not use this file except in compliance with the License.
6 | * You may obtain a copy of the License at
7 | *
8 | * http://www.apache.org/licenses/LICENSE-2.0
9 | *
10 | * Unless required by applicable law or agreed to in writing, software
11 | * distributed under the License is distributed on an "AS IS" BASIS,
12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 | * See the License for the specific language governing permissions and
14 | * limitations under the License.
15 | */
16 | /**
17 | * Custom exception implementations.
18 | *
19 | * @since 1.0.0
20 | */
21 | package com.netflix.hystrix.exception;
--------------------------------------------------------------------------------
/hystrix-core/src/main/java/com/netflix/hystrix/metric/HystrixEvent.java:
--------------------------------------------------------------------------------
1 | /**
2 | * Copyright 2015 Netflix, Inc.
3 | *
23 | * Default implementation is {@link HystrixRequestVariableDefault} managed by {@link HystrixRequestContext}.
24 | *
25 | * Custom implementations can be injected using {@link HystrixPlugins} and {@link HystrixConcurrencyStrategy#getRequestVariable}.
26 | *
27 | * See JavaDoc of {@link HystrixRequestContext} for more information about functionality this enables and how to use the default implementation.
28 | *
29 | * @param
28 | * When using the default implementation this is invoked when {@link HystrixRequestVariableDefault#get()} is called.
29 | *
30 | * @return T with initial value or null if none.
31 | */
32 | public T initialValue();
33 |
34 | /**
35 | * Invoked when request scope is shutdown to allow for cleanup.
36 | *
37 | * When using the default implementation this is invoked when {@link HystrixRequestContext#shutdown()} is called.
38 | *
39 | * The {@link HystrixRequestVariable#get()} method should not be called from within this method as it will result in {@link #initialValue()} being called again.
40 | *
41 | * @param value
42 | * of request variable to allow cleanup activity.
43 | *
44 | * If nothing needs to be cleaned up then nothing needs to be done in this method.
45 | */
46 | public void shutdown(T value);
47 |
48 | }
49 |
--------------------------------------------------------------------------------
/hystrix-core/src/main/java/com/netflix/hystrix/strategy/concurrency/package-info.java:
--------------------------------------------------------------------------------
1 | /**
2 | * Copyright 2012 Netflix, Inc.
3 | *
4 | * Licensed under the Apache License, Version 2.0 (the "License");
5 | * you may not use this file except in compliance with the License.
6 | * You may obtain a copy of the License at
7 | *
8 | * http://www.apache.org/licenses/LICENSE-2.0
9 | *
10 | * Unless required by applicable law or agreed to in writing, software
11 | * distributed under the License is distributed on an "AS IS" BASIS,
12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 | * See the License for the specific language governing permissions and
14 | * limitations under the License.
15 | */
16 | /**
17 | * Strategy definition for concurrency related behavior and default implementation.
18 | *
19 | * @since 1.0.0
20 | */
21 | package com.netflix.hystrix.strategy.concurrency;
--------------------------------------------------------------------------------
/hystrix-core/src/main/java/com/netflix/hystrix/strategy/eventnotifier/HystrixEventNotifierDefault.java:
--------------------------------------------------------------------------------
1 | /**
2 | * Copyright 2012 Netflix, Inc.
3 | *
4 | * Licensed under the Apache License, Version 2.0 (the "License");
5 | * you may not use this file except in compliance with the License.
6 | * You may obtain a copy of the License at
7 | *
8 | * http://www.apache.org/licenses/LICENSE-2.0
9 | *
10 | * Unless required by applicable law or agreed to in writing, software
11 | * distributed under the License is distributed on an "AS IS" BASIS,
12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 | * See the License for the specific language governing permissions and
14 | * limitations under the License.
15 | */
16 | package com.netflix.hystrix.strategy.eventnotifier;
17 |
18 |
19 | /**
20 | * Default implementations of {@link HystrixEventNotifier} that does nothing.
21 | *
22 | * @ExcludeFromJavadoc
23 | */
24 | public class HystrixEventNotifierDefault extends HystrixEventNotifier {
25 |
26 | private static HystrixEventNotifierDefault INSTANCE = new HystrixEventNotifierDefault();
27 |
28 | private HystrixEventNotifierDefault() {
29 |
30 | }
31 |
32 | public static HystrixEventNotifier getInstance() {
33 | return INSTANCE;
34 | }
35 |
36 |
37 | }
38 |
--------------------------------------------------------------------------------
/hystrix-core/src/main/java/com/netflix/hystrix/strategy/eventnotifier/package-info.java:
--------------------------------------------------------------------------------
1 | /**
2 | * Copyright 2012 Netflix, Inc.
3 | *
4 | * Licensed under the Apache License, Version 2.0 (the "License");
5 | * you may not use this file except in compliance with the License.
6 | * You may obtain a copy of the License at
7 | *
8 | * http://www.apache.org/licenses/LICENSE-2.0
9 | *
10 | * Unless required by applicable law or agreed to in writing, software
11 | * distributed under the License is distributed on an "AS IS" BASIS,
12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 | * See the License for the specific language governing permissions and
14 | * limitations under the License.
15 | */
16 | /**
17 | * Strategy definition for event notification.
18 | *
19 | * @since 1.0.0
20 | */
21 | package com.netflix.hystrix.strategy.eventnotifier;
--------------------------------------------------------------------------------
/hystrix-core/src/main/java/com/netflix/hystrix/strategy/executionhook/HystrixCommandExecutionHookDefault.java:
--------------------------------------------------------------------------------
1 | /**
2 | * Copyright 2013 Netflix, Inc.
3 | *
4 | * Licensed under the Apache License, Version 2.0 (the "License");
5 | * you may not use this file except in compliance with the License.
6 | * You may obtain a copy of the License at
7 | *
8 | * http://www.apache.org/licenses/LICENSE-2.0
9 | *
10 | * Unless required by applicable law or agreed to in writing, software
11 | * distributed under the License is distributed on an "AS IS" BASIS,
12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 | * See the License for the specific language governing permissions and
14 | * limitations under the License.
15 | */
16 | package com.netflix.hystrix.strategy.executionhook;
17 |
18 | /**
19 | * Default implementations of {@link HystrixCommandExecutionHook} that does nothing.
20 | *
21 | * @ExcludeFromJavadoc
22 | */
23 | public class HystrixCommandExecutionHookDefault extends HystrixCommandExecutionHook {
24 |
25 | private static HystrixCommandExecutionHookDefault INSTANCE = new HystrixCommandExecutionHookDefault();
26 |
27 | private HystrixCommandExecutionHookDefault() {
28 |
29 | }
30 |
31 | public static HystrixCommandExecutionHook getInstance() {
32 | return INSTANCE;
33 | }
34 |
35 | }
36 |
--------------------------------------------------------------------------------
/hystrix-core/src/main/java/com/netflix/hystrix/strategy/executionhook/package-info.java:
--------------------------------------------------------------------------------
1 | /**
2 | * Copyright 2013 Netflix, Inc.
3 | *
4 | * Licensed under the Apache License, Version 2.0 (the "License");
5 | * you may not use this file except in compliance with the License.
6 | * You may obtain a copy of the License at
7 | *
8 | * http://www.apache.org/licenses/LICENSE-2.0
9 | *
10 | * Unless required by applicable law or agreed to in writing, software
11 | * distributed under the License is distributed on an "AS IS" BASIS,
12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 | * See the License for the specific language governing permissions and
14 | * limitations under the License.
15 | */
16 | /**
17 | * Strategy definition for execution hook.
18 | *
19 | * @since 1.2.0
20 | */
21 | package com.netflix.hystrix.strategy.executionhook;
--------------------------------------------------------------------------------
/hystrix-core/src/main/java/com/netflix/hystrix/strategy/metrics/HystrixMetricsPublisherCollapser.java:
--------------------------------------------------------------------------------
1 | /**
2 | * Copyright 2012 Netflix, Inc.
3 | *
4 | * Licensed under the Apache License, Version 2.0 (the "License");
5 | * you may not use this file except in compliance with the License.
6 | * You may obtain a copy of the License at
7 | *
8 | * http://www.apache.org/licenses/LICENSE-2.0
9 | *
10 | * Unless required by applicable law or agreed to in writing, software
11 | * distributed under the License is distributed on an "AS IS" BASIS,
12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 | * See the License for the specific language governing permissions and
14 | * limitations under the License.
15 | */
16 | package com.netflix.hystrix.strategy.metrics;
17 |
18 | import com.netflix.hystrix.HystrixCollapser;
19 |
20 | /**
21 | * Metrics publisher for a {@link HystrixCollapser} that will be constructed by an implementation of {@link HystrixMetricsPublisher}.
22 | *
23 | * Instantiation of implementations of this interface should NOT allocate resources that require shutdown, register listeners or other such global state changes.
24 | *
25 | * The
27 | * Doing this logic in the constructor could result in memory leaks, double-publishing and other such behavior because this can be optimistically constructed more than once and "extras" discarded with
28 | * only one actually having
25 | * See Wiki docs about plugins for more information.
26 | *
27 | * @ExcludeFromJavadoc
28 | */
29 | public class HystrixMetricsPublisherCollapserDefault implements HystrixMetricsPublisherCollapser {
30 |
31 | public HystrixMetricsPublisherCollapserDefault(HystrixCollapserKey collapserKey, HystrixCollapserMetrics metrics, HystrixCollapserProperties properties) {
32 | // do nothing by default
33 | }
34 |
35 | @Override
36 | public void initialize() {
37 | // do nothing by default
38 | }
39 |
40 | }
41 |
--------------------------------------------------------------------------------
/hystrix-core/src/main/java/com/netflix/hystrix/strategy/metrics/HystrixMetricsPublisherCommand.java:
--------------------------------------------------------------------------------
1 | /**
2 | * Copyright 2012 Netflix, Inc.
3 | *
4 | * Licensed under the Apache License, Version 2.0 (the "License");
5 | * you may not use this file except in compliance with the License.
6 | * You may obtain a copy of the License at
7 | *
8 | * http://www.apache.org/licenses/LICENSE-2.0
9 | *
10 | * Unless required by applicable law or agreed to in writing, software
11 | * distributed under the License is distributed on an "AS IS" BASIS,
12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 | * See the License for the specific language governing permissions and
14 | * limitations under the License.
15 | */
16 | package com.netflix.hystrix.strategy.metrics;
17 |
18 | import com.netflix.hystrix.HystrixCommand;
19 |
20 | /**
21 | * Metrics publisher for a {@link HystrixCommand} that will be constructed by an implementation of {@link HystrixMetricsPublisher}.
22 | *
23 | * Instantiation of implementations of this interface should NOT allocate resources that require shutdown, register listeners or other such global state changes.
24 | *
25 | * The
27 | * Doing this logic in the constructor could result in memory leaks, double-publishing and other such behavior because this can be optimistically constructed more than once and "extras" discarded with
28 | * only one actually having
27 | * See Wiki docs about plugins for more information.
28 | *
29 | * @ExcludeFromJavadoc
30 | */
31 | public class HystrixMetricsPublisherCommandDefault implements HystrixMetricsPublisherCommand {
32 |
33 | public HystrixMetricsPublisherCommandDefault(HystrixCommandKey commandKey, HystrixCommandGroupKey commandGroupKey, HystrixCommandMetrics metrics, HystrixCircuitBreaker circuitBreaker, HystrixCommandProperties properties) {
34 | // do nothing by default
35 | }
36 |
37 | @Override
38 | public void initialize() {
39 | // do nothing by default
40 | }
41 |
42 | }
43 |
--------------------------------------------------------------------------------
/hystrix-core/src/main/java/com/netflix/hystrix/strategy/metrics/HystrixMetricsPublisherDefault.java:
--------------------------------------------------------------------------------
1 | /**
2 | * Copyright 2012 Netflix, Inc.
3 | *
4 | * Licensed under the Apache License, Version 2.0 (the "License");
5 | * you may not use this file except in compliance with the License.
6 | * You may obtain a copy of the License at
7 | *
8 | * http://www.apache.org/licenses/LICENSE-2.0
9 | *
10 | * Unless required by applicable law or agreed to in writing, software
11 | * distributed under the License is distributed on an "AS IS" BASIS,
12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 | * See the License for the specific language governing permissions and
14 | * limitations under the License.
15 | */
16 | package com.netflix.hystrix.strategy.metrics;
17 |
18 | /**
19 | * Default implementation of {@link HystrixMetricsPublisher}.
20 | *
21 | * See Wiki docs about plugins for more information.
22 | *
23 | * @ExcludeFromJavadoc
24 | */
25 | public class HystrixMetricsPublisherDefault extends HystrixMetricsPublisher {
26 |
27 | private static HystrixMetricsPublisherDefault INSTANCE = new HystrixMetricsPublisherDefault();
28 |
29 | public static HystrixMetricsPublisher getInstance() {
30 | return INSTANCE;
31 | }
32 |
33 | private HystrixMetricsPublisherDefault() {
34 | }
35 |
36 | }
37 |
--------------------------------------------------------------------------------
/hystrix-core/src/main/java/com/netflix/hystrix/strategy/metrics/HystrixMetricsPublisherThreadPool.java:
--------------------------------------------------------------------------------
1 | /**
2 | * Copyright 2012 Netflix, Inc.
3 | *
4 | * Licensed under the Apache License, Version 2.0 (the "License");
5 | * you may not use this file except in compliance with the License.
6 | * You may obtain a copy of the License at
7 | *
8 | * http://www.apache.org/licenses/LICENSE-2.0
9 | *
10 | * Unless required by applicable law or agreed to in writing, software
11 | * distributed under the License is distributed on an "AS IS" BASIS,
12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 | * See the License for the specific language governing permissions and
14 | * limitations under the License.
15 | */
16 | package com.netflix.hystrix.strategy.metrics;
17 |
18 | import com.netflix.hystrix.HystrixThreadPool;
19 |
20 | /**
21 | * Metrics publisher for a {@link HystrixThreadPool} that will be constructed by an implementation of {@link HystrixMetricsPublisher}.
22 | *
23 | * Instantiation of implementations of this interface should NOT allocate resources that require shutdown, register listeners or other such global state changes.
24 | *
25 | * The
27 | * Doing this logic in the constructor could result in memory leaks, double-publishing and other such behavior because this can be optimistically constructed more than once and "extras" discarded with
28 | * only one actually having
25 | * See Wiki docs about plugins for more information.
26 | *
27 | * @ExcludeFromJavadoc
28 | */
29 | public class HystrixMetricsPublisherThreadPoolDefault implements HystrixMetricsPublisherThreadPool {
30 |
31 | public HystrixMetricsPublisherThreadPoolDefault(HystrixThreadPoolKey threadPoolKey, HystrixThreadPoolMetrics metrics, HystrixThreadPoolProperties properties) {
32 | // do nothing by default
33 | }
34 |
35 | @Override
36 | public void initialize() {
37 | // do nothing by default
38 | }
39 |
40 | }
41 |
--------------------------------------------------------------------------------
/hystrix-core/src/main/java/com/netflix/hystrix/strategy/metrics/package-info.java:
--------------------------------------------------------------------------------
1 | /**
2 | * Copyright 2012 Netflix, Inc.
3 | *
4 | * Licensed under the Apache License, Version 2.0 (the "License");
5 | * you may not use this file except in compliance with the License.
6 | * You may obtain a copy of the License at
7 | *
8 | * http://www.apache.org/licenses/LICENSE-2.0
9 | *
10 | * Unless required by applicable law or agreed to in writing, software
11 | * distributed under the License is distributed on an "AS IS" BASIS,
12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 | * See the License for the specific language governing permissions and
14 | * limitations under the License.
15 | */
16 | /**
17 | * Strategy definition for publishing metrics and default implementation.
18 | *
19 | * @since 1.0.0
20 | */
21 | package com.netflix.hystrix.strategy.metrics;
--------------------------------------------------------------------------------
/hystrix-core/src/main/java/com/netflix/hystrix/strategy/package-info.java:
--------------------------------------------------------------------------------
1 | /**
2 | * Copyright 2012 Netflix, Inc.
3 | *
4 | * Licensed under the Apache License, Version 2.0 (the "License");
5 | * you may not use this file except in compliance with the License.
6 | * You may obtain a copy of the License at
7 | *
8 | * http://www.apache.org/licenses/LICENSE-2.0
9 | *
10 | * Unless required by applicable law or agreed to in writing, software
11 | * distributed under the License is distributed on an "AS IS" BASIS,
12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 | * See the License for the specific language governing permissions and
14 | * limitations under the License.
15 | */
16 | /**
17 | * Parent package of strategies and plugin management.
18 | *
19 | * @since 1.0.0
20 | */
21 | package com.netflix.hystrix.strategy;
--------------------------------------------------------------------------------
/hystrix-core/src/main/java/com/netflix/hystrix/strategy/properties/HystrixDynamicProperty.java:
--------------------------------------------------------------------------------
1 | /**
2 | * Copyright 2016 Netflix, Inc.
3 | * initialize() method will be called once-and-only-once to indicate when this instance can register with external services, start publishing metrics etc.
26 | * initialize() called on it.
29 | */
30 | public interface HystrixMetricsPublisherCollapser {
31 |
32 | // TODO should the arguments be given via initialize rather than constructor so people can't accidentally do it wrong?
33 |
34 | public void initialize();
35 |
36 | }
37 |
--------------------------------------------------------------------------------
/hystrix-core/src/main/java/com/netflix/hystrix/strategy/metrics/HystrixMetricsPublisherCollapserDefault.java:
--------------------------------------------------------------------------------
1 | /**
2 | * Copyright 2012 Netflix, Inc.
3 | *
4 | * Licensed under the Apache License, Version 2.0 (the "License");
5 | * you may not use this file except in compliance with the License.
6 | * You may obtain a copy of the License at
7 | *
8 | * http://www.apache.org/licenses/LICENSE-2.0
9 | *
10 | * Unless required by applicable law or agreed to in writing, software
11 | * distributed under the License is distributed on an "AS IS" BASIS,
12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 | * See the License for the specific language governing permissions and
14 | * limitations under the License.
15 | */
16 | package com.netflix.hystrix.strategy.metrics;
17 |
18 | import com.netflix.hystrix.HystrixCollapserKey;
19 | import com.netflix.hystrix.HystrixCollapserMetrics;
20 | import com.netflix.hystrix.HystrixCollapserProperties;
21 |
22 | /**
23 | * Default implementation of {@link HystrixMetricsPublisherCollapser} that does nothing.
24 | * initialize() method will be called once-and-only-once to indicate when this instance can register with external services, start publishing metrics etc.
26 | * initialize() called on it.
29 | */
30 | public interface HystrixMetricsPublisherCommand {
31 |
32 | // TODO should the arguments be given via initialize rather than constructor so they can't accidentally do it wrong?
33 |
34 | public void initialize();
35 |
36 | }
37 |
--------------------------------------------------------------------------------
/hystrix-core/src/main/java/com/netflix/hystrix/strategy/metrics/HystrixMetricsPublisherCommandDefault.java:
--------------------------------------------------------------------------------
1 | /**
2 | * Copyright 2012 Netflix, Inc.
3 | *
4 | * Licensed under the Apache License, Version 2.0 (the "License");
5 | * you may not use this file except in compliance with the License.
6 | * You may obtain a copy of the License at
7 | *
8 | * http://www.apache.org/licenses/LICENSE-2.0
9 | *
10 | * Unless required by applicable law or agreed to in writing, software
11 | * distributed under the License is distributed on an "AS IS" BASIS,
12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 | * See the License for the specific language governing permissions and
14 | * limitations under the License.
15 | */
16 | package com.netflix.hystrix.strategy.metrics;
17 |
18 | import com.netflix.hystrix.HystrixCircuitBreaker;
19 | import com.netflix.hystrix.HystrixCommandGroupKey;
20 | import com.netflix.hystrix.HystrixCommandKey;
21 | import com.netflix.hystrix.HystrixCommandMetrics;
22 | import com.netflix.hystrix.HystrixCommandProperties;
23 |
24 | /**
25 | * Default implementation of {@link HystrixMetricsPublisherCommand} that does nothing.
26 | * initialize() method will be called once-and-only-once to indicate when this instance can register with external services, start publishing metrics etc.
26 | * initialize() called on it.
29 | */
30 | public interface HystrixMetricsPublisherThreadPool {
31 |
32 | // TODO should the arguments be given via initialize rather than constructor so people can't accidentally do it wrong?
33 |
34 | public void initialize();
35 |
36 | }
37 |
--------------------------------------------------------------------------------
/hystrix-core/src/main/java/com/netflix/hystrix/strategy/metrics/HystrixMetricsPublisherThreadPoolDefault.java:
--------------------------------------------------------------------------------
1 | /**
2 | * Copyright 2012 Netflix, Inc.
3 | *
4 | * Licensed under the Apache License, Version 2.0 (the "License");
5 | * you may not use this file except in compliance with the License.
6 | * You may obtain a copy of the License at
7 | *
8 | * http://www.apache.org/licenses/LICENSE-2.0
9 | *
10 | * Unless required by applicable law or agreed to in writing, software
11 | * distributed under the License is distributed on an "AS IS" BASIS,
12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 | * See the License for the specific language governing permissions and
14 | * limitations under the License.
15 | */
16 | package com.netflix.hystrix.strategy.metrics;
17 |
18 | import com.netflix.hystrix.HystrixThreadPoolKey;
19 | import com.netflix.hystrix.HystrixThreadPoolMetrics;
20 | import com.netflix.hystrix.HystrixThreadPoolProperties;
21 |
22 | /**
23 | * Default implementation of {@link HystrixMetricsPublisherThreadPool} that does nothing.
24 | * 
20 |
--------------------------------------------------------------------------------
/hystrix-examples-webapp/build.gradle:
--------------------------------------------------------------------------------
1 | buildscript {
2 | repositories {
3 | maven {
4 | url "https://plugins.gradle.org/m2/"
5 | }
6 | }
7 | dependencies {
8 | classpath "org.gretty:gretty:3.0.5"
9 | }
10 | }
11 |
12 | apply plugin: "org.gretty"
13 | apply plugin: 'war'
14 |
15 |
16 | dependencies {
17 | api project(':hystrix-core')
18 | api project(':hystrix-examples')
19 | api project(':hystrix-request-servlet')
20 | api project(':hystrix-metrics-event-stream')
21 | }
22 |
23 | gretty {
24 | httpPort = 8989
25 | servletContainer = 'jetty9'
26 | }
27 |
--------------------------------------------------------------------------------
/hystrix-examples-webapp/src/main/webapp/WEB-INF/classes/log4j.properties:
--------------------------------------------------------------------------------
1 | log4j.rootLogger=INFO, FILE
2 | log4j.appender.FILE=org.apache.log4j.ConsoleAppender
3 | log4j.appender.FILE.layout=org.apache.log4j.PatternLayout
4 | log4j.appender.FILE.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss} %p %C:%L [%C{1}] [%M]: %m%n
5 |
6 | log4j.appender.FILE.httpclient=ERROR
7 |
--------------------------------------------------------------------------------
/hystrix-examples/build.gradle:
--------------------------------------------------------------------------------
1 | dependencies {
2 | api project(':hystrix-core')
3 | compileOnly 'junit:junit-dep:4.10'
4 | }
5 |
6 | task(runDemo, dependsOn: 'classes', type: JavaExec) {
7 | main = 'com.netflix.hystrix.examples.demo.HystrixCommandDemo'
8 | classpath = sourceSets.main.runtimeClasspath
9 | }
10 |
--------------------------------------------------------------------------------
/hystrix-examples/src/main/java/com/netflix/hystrix/examples/basic/CommandUsingSemaphoreIsolation.java:
--------------------------------------------------------------------------------
1 | /**
2 | * Copyright 2012 Netflix, Inc.
3 | *
4 | * Licensed under the Apache License, Version 2.0 (the "License");
5 | * you may not use this file except in compliance with the License.
6 | * You may obtain a copy of the License at
7 | *
8 | * http://www.apache.org/licenses/LICENSE-2.0
9 | *
10 | * Unless required by applicable law or agreed to in writing, software
11 | * distributed under the License is distributed on an "AS IS" BASIS,
12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 | * See the License for the specific language governing permissions and
14 | * limitations under the License.
15 | */
16 | package com.netflix.hystrix.examples.basic;
17 |
18 | import com.netflix.hystrix.HystrixCommand;
19 | import com.netflix.hystrix.HystrixCommandGroupKey;
20 | import com.netflix.hystrix.HystrixCommandProperties;
21 | import com.netflix.hystrix.HystrixCommandProperties.ExecutionIsolationStrategy;
22 |
23 | /**
24 | * Example of {@link HystrixCommand} defaulting to use a semaphore isolation strategy
25 | * when its run() method will not perform network traffic.
26 | */
27 | public class CommandUsingSemaphoreIsolation extends HystrixCommand