DeliveryListener. That is to say that once passed to the
32 | * DeliveryListener the client will never modify the data held
33 | * in this buffer.
34 | */
35 | ByteBuffer getData();
36 | }
37 |
--------------------------------------------------------------------------------
/mqlight/src/main/java/com/ibm/mqlight/api/ClientException.java:
--------------------------------------------------------------------------------
1 | /**
2 | * Licensed to the Apache Software Foundation (ASF) under one
3 | * or more contributor license agreements. See the NOTICE file
4 | * distributed with this work for additional information
5 | * regarding copyright ownership. The ASF licenses this file
6 | * to you under the Apache License, Version 2.0 (the
7 | * "License"); you may not use this file except in compliance
8 | * with the License. You may obtain a copy of the License at
9 | *
10 | * http://www.apache.org/licenses/LICENSE-2.0
11 | *
12 | * Unless required by applicable law or agreed to in writing,
13 | * software distributed under the License is distributed on an
14 | * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
15 | * KIND, either express or implied. See the License for the
16 | * specific language governing permissions and limitations
17 | * under the License.
18 | */
19 | package com.ibm.mqlight.api;
20 |
21 | /**
22 | * Superclass of all MQ Light specific client checked exceptions
23 | */
24 | public class ClientException extends Exception {
25 |
26 | private static final long serialVersionUID = 5343791367613494183L;
27 |
28 | public ClientException(String message, Throwable cause) {
29 | super(message, cause);
30 | }
31 |
32 | public ClientException(String message) {
33 | super(message);
34 | }
35 | }
36 |
--------------------------------------------------------------------------------
/mqlight/src/main/java/com/ibm/mqlight/api/ClientRuntimeException.java:
--------------------------------------------------------------------------------
1 | /**
2 | * Licensed to the Apache Software Foundation (ASF) under one
3 | * or more contributor license agreements. See the NOTICE file
4 | * distributed with this work for additional information
5 | * regarding copyright ownership. The ASF licenses this file
6 | * to you under the Apache License, Version 2.0 (the
7 | * "License"); you may not use this file except in compliance
8 | * with the License. You may obtain a copy of the License at
9 | *
10 | * http://www.apache.org/licenses/LICENSE-2.0
11 | *
12 | * Unless required by applicable law or agreed to in writing,
13 | * software distributed under the License is distributed on an
14 | * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
15 | * KIND, either express or implied. See the License for the
16 | * specific language governing permissions and limitations
17 | * under the License.
18 | */
19 | package com.ibm.mqlight.api;
20 |
21 | /**
22 | * Superclass of all MQ Light specific client unchecked exceptions
23 | */
24 | public class ClientRuntimeException extends RuntimeException {
25 |
26 | private static final long serialVersionUID = -7670482333474200402L;
27 |
28 | public ClientRuntimeException(String message) {
29 | super(message);
30 | }
31 |
32 | public ClientRuntimeException(String message, Throwable cause) {
33 | super(message, cause);
34 | }
35 | }
36 |
--------------------------------------------------------------------------------
/mqlight/src/main/java/com/ibm/mqlight/api/ClientState.java:
--------------------------------------------------------------------------------
1 | /**
2 | * Licensed to the Apache Software Foundation (ASF) under one
3 | * or more contributor license agreements. See the NOTICE file
4 | * distributed with this work for additional information
5 | * regarding copyright ownership. The ASF licenses this file
6 | * to you under the Apache License, Version 2.0 (the
7 | * "License"); you may not use this file except in compliance
8 | * with the License. You may obtain a copy of the License at
9 | *
10 | * http://www.apache.org/licenses/LICENSE-2.0
11 | *
12 | * Unless required by applicable law or agreed to in writing,
13 | * software distributed under the License is distributed on an
14 | * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
15 | * KIND, either express or implied. See the License for the
16 | * specific language governing permissions and limitations
17 | * under the License.
18 | */
19 | package com.ibm.mqlight.api;
20 |
21 | /**
22 | * An enumeration used to describe the state of the MQ Light client. This is the state
23 | * machine backing the client:
24 | * 
25 | */
26 | public enum ClientState {
27 | STARTING, STARTED, STOPPING, STOPPED, RETRYING
28 | }
29 |
--------------------------------------------------------------------------------
/mqlight/src/main/java/com/ibm/mqlight/api/CompletionListener.java:
--------------------------------------------------------------------------------
1 | /**
2 | * Licensed to the Apache Software Foundation (ASF) under one
3 | * or more contributor license agreements. See the NOTICE file
4 | * distributed with this work for additional information
5 | * regarding copyright ownership. The ASF licenses this file
6 | * to you under the Apache License, Version 2.0 (the
7 | * "License"); you may not use this file except in compliance
8 | * with the License. You may obtain a copy of the License at
9 | *
10 | * http://www.apache.org/licenses/LICENSE-2.0
11 | *
12 | * Unless required by applicable law or agreed to in writing,
13 | * software distributed under the License is distributed on an
14 | * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
15 | * KIND, either express or implied. See the License for the
16 | * specific language governing permissions and limitations
17 | * under the License.
18 | */
19 | package com.ibm.mqlight.api;
20 |
21 | /**
22 | * A listener for completion of NonBlockingClient operations. For example:
23 | *
24 | * NonBlockingClient client = // ... initialization code
25 | *
26 | * client.send("/kittens", "Hello kitty!", new CompletionListener() {
27 | * public void onSuccess(NonBlockingClient c, // c == client
28 | * Object ctx) {
29 | * // ... code for handling success of send operation
30 | * }
31 | * public void onError(NonBlockingClient c, // c == client
32 | * Object ctx,
33 | * ClientCheckedException exception) {
34 | * // ... code for handing failure of send operation - for example:
35 | * exception.printStackTrace(); // The reason the operation failed.
36 | * }
37 | * }, null); // This value is passed into the listener as the context argument...
38 | *
39 | */
40 | public interface CompletionListenernull if the JSON is a representation of null).
40 | * @throws JsonSyntaxException if the JSON data cannot be deserialized into an object of type classOfT.
41 | */
42 | null if the JSON is a representation of null).
51 | * @throws JsonSyntaxException if the JSON data cannot be deserialized into an object of type typeOfT.
52 | */
53 | String representation of the JSON. This allows other parsers to be used.
64 | */
65 | String getRawData();
66 | }
67 |
--------------------------------------------------------------------------------
/mqlight/src/main/java/com/ibm/mqlight/api/MalformedDelivery.java:
--------------------------------------------------------------------------------
1 | /**
2 | * Licensed to the Apache Software Foundation (ASF) under one
3 | * or more contributor license agreements. See the NOTICE file
4 | * distributed with this work for additional information
5 | * regarding copyright ownership. The ASF licenses this file
6 | * to you under the Apache License, Version 2.0 (the
7 | * "License"); you may not use this file except in compliance
8 | * with the License. You may obtain a copy of the License at
9 | *
10 | * http://www.apache.org/licenses/LICENSE-2.0
11 | *
12 | * Unless required by applicable law or agreed to in writing,
13 | * software distributed under the License is distributed on an
14 | * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
15 | * KIND, either express or implied. See the License for the
16 | * specific language governing permissions and limitations
17 | * under the License.
18 | */
19 | package com.ibm.mqlight.api;
20 |
21 | public interface MalformedDelivery extends BytesDelivery {
22 |
23 | /**
24 | * Describes the reason that a message has been delivered using the onMalformed(...)
25 | * method.
26 | */
27 | enum MalformedReason {
28 | FORMATNOMAPPING,
29 | JMSNOMAPPING,
30 | PAYLOADENCODING,
31 | PAYLOADNOTAMQP
32 | }
33 |
34 | MalformedReason getReason();
35 |
36 | String getDescription();
37 |
38 | String getMQMDFormat();
39 |
40 | int getMQMDCodedCharSetId();
41 | }
42 |
--------------------------------------------------------------------------------
/mqlight/src/main/java/com/ibm/mqlight/api/NetworkException.java:
--------------------------------------------------------------------------------
1 | /**
2 | * Licensed to the Apache Software Foundation (ASF) under one
3 | * or more contributor license agreements. See the NOTICE file
4 | * distributed with this work for additional information
5 | * regarding copyright ownership. The ASF licenses this file
6 | * to you under the Apache License, Version 2.0 (the
7 | * "License"); you may not use this file except in compliance
8 | * with the License. You may obtain a copy of the License at
9 | *
10 | * http://www.apache.org/licenses/LICENSE-2.0
11 | *
12 | * Unless required by applicable law or agreed to in writing,
13 | * software distributed under the License is distributed on an
14 | * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
15 | * KIND, either express or implied. See the License for the
16 | * specific language governing permissions and limitations
17 | * under the License.
18 | */
19 | package com.ibm.mqlight.api;
20 |
21 | /**
22 | * Used to indicate that a client has failed due to a network related problem. In this case
23 | * the client is disconnected from the MQ Light server and notified using an
24 | * instance of this exception.
25 | */
26 | public class NetworkException extends ClientException {
27 |
28 | private static final long serialVersionUID = -1910478698106122154L;
29 |
30 | public NetworkException(String message) {
31 | super(message);
32 | }
33 |
34 | public NetworkException(String message, Throwable cause) {
35 | super(message, cause);
36 | }
37 | }
38 |
--------------------------------------------------------------------------------
/mqlight/src/main/java/com/ibm/mqlight/api/NonBlockingClientAdapter.java:
--------------------------------------------------------------------------------
1 | /**
2 | * Licensed to the Apache Software Foundation (ASF) under one
3 | * or more contributor license agreements. See the NOTICE file
4 | * distributed with this work for additional information
5 | * regarding copyright ownership. The ASF licenses this file
6 | * to you under the Apache License, Version 2.0 (the
7 | * "License"); you may not use this file except in compliance
8 | * with the License. You may obtain a copy of the License at
9 | *
10 | * http://www.apache.org/licenses/LICENSE-2.0
11 | *
12 | * Unless required by applicable law or agreed to in writing,
13 | * software distributed under the License is distributed on an
14 | * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
15 | * KIND, either express or implied. See the License for the
16 | * specific language governing permissions and limitations
17 | * under the License.
18 | */
19 | package com.ibm.mqlight.api;
20 |
21 | import com.ibm.mqlight.api.logging.Logger;
22 | import com.ibm.mqlight.api.logging.LoggerFactory;
23 |
24 | /**
25 | * An abstract adapter class for receiving client events. The methods in this class are empty.
26 | * This class exists as convenience for creating client listener objects. Extend this class to
27 | * create a NonBlockingClientListener object and override the methods for the events of interest.
28 | * (If you implement the NonBlockingClientListener interface, you have to define all of the methods in it.
29 | * This abstract class defines null methods for them all, so you can only have to define methods for
30 | * events you care about.)
31 | */
32 | public abstract class NonBlockingClientAdapterString object containing the textual data.
29 | */
30 | String getData();
31 | }
32 |
--------------------------------------------------------------------------------
/mqlight/src/main/java/com/ibm/mqlight/api/SubscribedException.java:
--------------------------------------------------------------------------------
1 | /**
2 | * Licensed to the Apache Software Foundation (ASF) under one
3 | * or more contributor license agreements. See the NOTICE file
4 | * distributed with this work for additional information
5 | * regarding copyright ownership. The ASF licenses this file
6 | * to you under the Apache License, Version 2.0 (the
7 | * "License"); you may not use this file except in compliance
8 | * with the License. You may obtain a copy of the License at
9 | *
10 | * http://www.apache.org/licenses/LICENSE-2.0
11 | *
12 | * Unless required by applicable law or agreed to in writing,
13 | * software distributed under the License is distributed on an
14 | * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
15 | * KIND, either express or implied. See the License for the
16 | * specific language governing permissions and limitations
17 | * under the License.
18 | */
19 | package com.ibm.mqlight.api;
20 |
21 | /**
22 | * A type of {@link StateException} to indicate that the client is attempting to subscribe to a destination for which the client is already subscribed.
23 | */
24 | public class SubscribedException extends StateException {
25 |
26 | private static final long serialVersionUID = 2792420197537041736L;
27 |
28 | public SubscribedException(String message) {
29 | super(message);
30 | }
31 | }
32 |
--------------------------------------------------------------------------------
/mqlight/src/main/java/com/ibm/mqlight/api/UnsubscribedException.java:
--------------------------------------------------------------------------------
1 | /**
2 | * Licensed to the Apache Software Foundation (ASF) under one
3 | * or more contributor license agreements. See the NOTICE file
4 | * distributed with this work for additional information
5 | * regarding copyright ownership. The ASF licenses this file
6 | * to you under the Apache License, Version 2.0 (the
7 | * "License"); you may not use this file except in compliance
8 | * with the License. You may obtain a copy of the License at
9 | *
10 | * http://www.apache.org/licenses/LICENSE-2.0
11 | *
12 | * Unless required by applicable law or agreed to in writing,
13 | * software distributed under the License is distributed on an
14 | * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
15 | * KIND, either express or implied. See the License for the
16 | * specific language governing permissions and limitations
17 | * under the License.
18 | */
19 | package com.ibm.mqlight.api;
20 |
21 | /**
22 | * A type of {@link StateException} to indicate that the client is attempting to unsubscribe from a destination for which the client is not already subscribed.
23 | */
24 | public class UnsubscribedException extends StateException {
25 |
26 | private static final long serialVersionUID = 2198833574106117937L;
27 |
28 | public UnsubscribedException(String message) {
29 | super(message);
30 | }
31 | }
32 |
--------------------------------------------------------------------------------
/mqlight/src/main/java/com/ibm/mqlight/api/callback/CallbackService.java:
--------------------------------------------------------------------------------
1 | /**
2 | * Licensed to the Apache Software Foundation (ASF) under one
3 | * or more contributor license agreements. See the NOTICE file
4 | * distributed with this work for additional information
5 | * regarding copyright ownership. The ASF licenses this file
6 | * to you under the Apache License, Version 2.0 (the
7 | * "License"); you may not use this file except in compliance
8 | * with the License. You may obtain a copy of the License at
9 | *
10 | * http://www.apache.org/licenses/LICENSE-2.0
11 | *
12 | * Unless required by applicable law or agreed to in writing,
13 | * software distributed under the License is distributed on an
14 | * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
15 | * KIND, either express or implied. See the License for the
16 | * specific language governing permissions and limitations
17 | * under the License.
18 | */
19 | package com.ibm.mqlight.api.callback;
20 |
21 | import com.ibm.mqlight.api.NonBlockingClient;
22 | import com.ibm.mqlight.api.Promise;
23 |
24 | /**
25 | * Plug point for callback executing implementations. The implementation used for an
26 | * instance of the client can be specified using the
27 | * {@link NonBlockingClient#create(com.ibm.mqlight.api.endpoint.EndpointService, com.ibm.mqlight.api.callback.CallbackService, com.ibm.mqlight.api.network.NetworkService, com.ibm.mqlight.api.timer.TimerService, com.google.gson.GsonBuilder, com.ibm.mqlight.api.ClientOptions, com.ibm.mqlight.api.NonBlockingClientListener, Object)}
28 | * method.
29 | */
30 | public interface CallbackService {
31 |
32 | /**
33 | * Run the specified runnable. This method will be invoked each time the client
34 | * needs to call back into application code.
35 | *
36 | * @param runnable the Runnable to run.
37 | * @param orderingCtx an object that is used to order the execution of runnables.
38 | * The implementor of this interface must ensure that if two
39 | * calls specify the same orderingCtx object they
40 | * are executed in the order the calls are made. Two calls that
41 | * specify different values for the orderingCtx
42 | * parameter can have their runnables executed in any order.
43 | * @param promise a promise which is to be completed when the runnable has finished
44 | * executing.
45 | */
46 | void run(Runnable runnable, Object orderingCtx, Promisenull
50 | * then the SASL ANONYMOUS mechanism will be used instead.
51 | */
52 | String getUser();
53 |
54 | /**
55 | * @return the password to use as part of a SASL PLAIN flow used to
56 | * authenticate the client.
57 | */
58 | String getPassword();
59 |
60 | /**
61 | * @return the maximum idle period between activity (frames) on the
62 | * connection that the client desires from this endpoint.
63 | */
64 | int getIdleTimeout();
65 |
66 | /**
67 | * @return The URI for this endpoint, derived from the host and port,
68 | * and taking into account whether or not SSL/TLS is enabled.
69 | */
70 | URI getURI();
71 |
72 | /**
73 | * @return the required SSL/TLS options.
74 | */
75 | SSLOptions getSSLOptions();
76 |
77 | }
78 |
--------------------------------------------------------------------------------
/mqlight/src/main/java/com/ibm/mqlight/api/endpoint/EndpointPromise.java:
--------------------------------------------------------------------------------
1 | /**
2 | * Licensed to the Apache Software Foundation (ASF) under one
3 | * or more contributor license agreements. See the NOTICE file
4 | * distributed with this work for additional information
5 | * regarding copyright ownership. The ASF licenses this file
6 | * to you under the Apache License, Version 2.0 (the
7 | * "License"); you may not use this file except in compliance
8 | * with the License. You may obtain a copy of the License at
9 | *
10 | * http://www.apache.org/licenses/LICENSE-2.0
11 | *
12 | * Unless required by applicable law or agreed to in writing,
13 | * software distributed under the License is distributed on an
14 | * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
15 | * KIND, either express or implied. See the License for the
16 | * specific language governing permissions and limitations
17 | * under the License.
18 | */
19 | package com.ibm.mqlight.api.endpoint;
20 |
21 | import com.ibm.mqlight.api.Promise;
22 |
23 | /**
24 | * A promise that is used to indicate the outcome of an endpoint lookup
25 | * operation. The inherited {@link Promise#setSuccess(Object)}
26 | * method is used when the lookup operation is successful and returns an
27 | * {@link Endpoint}. The inherited {@link Promise#setFailure(Exception)}
28 | * method is used when the lookup operation fails and the client should
29 | * transition into stopped state. The {@link EndpointPromise#setWait(long)}
30 | * method is used to indicate that the client should wait for a period of
31 | * time before making more endpoint lookup requests
32 | */
33 | public interface EndpointPromise extends Promise
36 | * When the operation completes the promise (supplied as an argument) is used to
37 | * notify the client of the outcome. If an endpoint is available it will be
38 | * supplied to the {@link Promise#setSuccess(Object)} method. If no
39 | * endpoints are currently available, the client can be advised to wait for a
40 | * period of time before calling this method again using the {@link EndpointPromise#setWait(long)}
41 | * method. Indicating failure by calling the {@link EndpointPromise#setFailure(Exception)}
42 | * will cause the client to transition into
36 | * The action is invoked whenever a connection is recovered.
37 | */
38 | void remakeInboundLinks();
39 |
40 | void blessEndpoint();
41 |
42 | /**
43 | * This action performs the cleanup operations such as flushing/failing any pending sends or subscribes.
44 | *
45 | * The action can be invoked when a client is stopping.
46 | */
47 | void cleanup();
48 |
49 | void failPendingStops();
50 |
51 | void succeedPendingStops();
52 |
53 | void failPendingStarts();
54 |
55 | void succeedPendingStarts();
56 |
57 | // All of these relate to external state machine transitions
58 | void eventStarting();
59 | void eventUserStopping();
60 | void eventSystemStopping();
61 | void eventStopped();
62 | void eventStarted();
63 | void eventRetrying();
64 | void eventRestarted();
65 |
66 | /**
67 | * This action breaks any pending sends and subscription requests from the client
68 | *
69 | * The action is invoked whenever a network error occurs and the client is not stopping.
70 | */
71 | void breakInboundLinks();
72 |
73 | void processQueuedActions();
74 |
75 | }
76 |
--------------------------------------------------------------------------------
/mqlight/src/main/java/com/ibm/mqlight/api/impl/InternalSend.java:
--------------------------------------------------------------------------------
1 | /**
2 | * Licensed to the Apache Software Foundation (ASF) under one
3 | * or more contributor license agreements. See the NOTICE file
4 | * distributed with this work for additional information
5 | * regarding copyright ownership. The ASF licenses this file
6 | * to you under the Apache License, Version 2.0 (the
7 | * "License"); you may not use this file except in compliance
8 | * with the License. You may obtain a copy of the License at
9 | *
10 | * http://www.apache.org/licenses/LICENSE-2.0
11 | *
12 | * Unless required by applicable law or agreed to in writing,
13 | * software distributed under the License is distributed on an
14 | * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
15 | * KIND, either express or implied. See the License for the
16 | * specific language governing permissions and limitations
17 | * under the License.
18 | */
19 | package com.ibm.mqlight.api.impl;
20 |
21 | import io.netty.buffer.ByteBuf;
22 |
23 | import com.ibm.mqlight.api.QOS;
24 | import com.ibm.mqlight.api.logging.Logger;
25 | import com.ibm.mqlight.api.logging.LoggerFactory;
26 |
27 | class InternalSend
32 | * Note that the client id is obtained from the MDC (Mapped Diagnostic Context), which can be set from the {@link Logger#setClientId(String)} method.
33 | */
34 | public class ClientIdConverter extends ClassicConverter {
35 |
36 | @Override
37 | public String convert(ILoggingEvent event) {
38 | final Map
35 | * Note that the {@link #convert(ILoggingEvent)} method simply returns a {@link String} with a single character based on the passed event's marker (if the marker is not recognised
36 | * or no marker is present, a {@link String} with a single space character is returned).
37 | *
38 | * Actual indenting has not been implemented as it will affect trace performance. Using a suitable Boss trace filter it will be possible for Boss trace to format and indent as
39 | * required anyway, hence indentation is not required by the service team.
40 | */
41 | public class IndentConverter extends ClassicConverter {
42 |
43 | private static Map
30 | * When a passed event contains a matrker, the {@link #convert(ILoggingEvent)} method simply returns a {@link String} with text for the marker, otherwise the a {@link String} for the event's level is returned.
31 | */
32 | public class LevelConverter extends ClassicConverter {
33 |
34 | @Override
35 | public String convert(ILoggingEvent event) {
36 | final Marker marker = event.getMarker();
37 | return marker == null ? (event.getLevel() == null ? "" : event.getLevel().toString()) : marker.getName();
38 | }
39 |
40 | }
41 |
--------------------------------------------------------------------------------
/mqlight/src/main/java/com/ibm/mqlight/api/impl/logging/logback/LogFilter.java:
--------------------------------------------------------------------------------
1 | /**
2 | * Licensed to the Apache Software Foundation (ASF) under one
3 | * or more contributor license agreements. See the NOTICE file
4 | * distributed with this work for additional information
5 | * regarding copyright ownership. The ASF licenses this file
6 | * to you under the Apache License, Version 2.0 (the
7 | * "License"); you may not use this file except in compliance
8 | * with the License. You may obtain a copy of the License at
9 | *
10 | * http://www.apache.org/licenses/LICENSE-2.0
11 | *
12 | * Unless required by applicable law or agreed to in writing,
13 | * software distributed under the License is distributed on an
14 | * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
15 | * KIND, either express or implied. See the License for the
16 | * specific language governing permissions and limitations
17 | * under the License.
18 | */
19 |
20 | package com.ibm.mqlight.api.impl.logging.logback;
21 |
22 | import ch.qos.logback.classic.spi.ILoggingEvent;
23 | import ch.qos.logback.core.filter.Filter;
24 | import ch.qos.logback.core.spi.FilterReply;
25 |
26 | /**
27 | * A logback filter for selecting MQ Light events that are not trace.
28 | */
29 | public class LogFilter extends Filter
23 | * Note that this assumes that whenever the event has one of the trace markers (defined in {@link TraceFilter}) then the first argument for the event specifies the object id, or
24 | * null implying no object id is appropriate.
25 | */
26 | package com.ibm.mqlight.api.impl.logging.logback;
27 |
28 | import org.slf4j.Marker;
29 |
30 | import ch.qos.logback.classic.pattern.ClassicConverter;
31 | import ch.qos.logback.classic.spi.ILoggingEvent;
32 |
33 | public class ObjectIdConverter extends ClassicConverter {
34 |
35 | @Override
36 | public String convert(ILoggingEvent event) {
37 | final String result;
38 | final Marker marker = event.getMarker();
39 | if (TraceFilter.traceMarkerMap.containsKey(marker)) {
40 | final Object args[] = event.getArgumentArray();
41 | if (args != null && args.length > 0) {
42 | Object obj = event.getArgumentArray()[0];
43 | result = obj == null ? "static" : "@"+Integer.toHexString(System.identityHashCode(obj));
44 | } else {
45 | result = "";
46 | }
47 | } else {
48 | result = "";
49 | }
50 | return result;
51 | }
52 |
53 | }
54 |
--------------------------------------------------------------------------------
/mqlight/src/main/java/com/ibm/mqlight/api/impl/logging/logback/PIDConverter.java:
--------------------------------------------------------------------------------
1 | /**
2 | * Licensed to the Apache Software Foundation (ASF) under one
3 | * or more contributor license agreements. See the NOTICE file
4 | * distributed with this work for additional information
5 | * regarding copyright ownership. The ASF licenses this file
6 | * to you under the Apache License, Version 2.0 (the
7 | * "License"); you may not use this file except in compliance
8 | * with the License. You may obtain a copy of the License at
9 | *
10 | * http://www.apache.org/licenses/LICENSE-2.0
11 | *
12 | * Unless required by applicable law or agreed to in writing,
13 | * software distributed under the License is distributed on an
14 | * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
15 | * KIND, either express or implied. See the License for the
16 | * specific language governing permissions and limitations
17 | * under the License.
18 | */
19 |
20 | package com.ibm.mqlight.api.impl.logging.logback;
21 |
22 | import ch.qos.logback.classic.pattern.ClassicConverter;
23 | import ch.qos.logback.classic.spi.ILoggingEvent;
24 |
25 | /**
26 | * A logback converter to support a process id customer conversion specifier.
27 | */
28 | public class PIDConverter extends ClassicConverter {
29 |
30 | static final String pid;
31 | static {
32 | final String processName = java.lang.management.ManagementFactory.getRuntimeMXBean().getName();
33 | pid = processName.split("@")[0];
34 | }
35 |
36 | @Override
37 | public String convert(ILoggingEvent event) {
38 | return pid;
39 | }
40 |
41 | }
42 |
--------------------------------------------------------------------------------
/mqlight/src/main/java/com/ibm/mqlight/api/impl/logging/logback/TIDConverter.java:
--------------------------------------------------------------------------------
1 | /**
2 | * Licensed to the Apache Software Foundation (ASF) under one
3 | * or more contributor license agreements. See the NOTICE file
4 | * distributed with this work for additional information
5 | * regarding copyright ownership. The ASF licenses this file
6 | * to you under the Apache License, Version 2.0 (the
7 | * "License"); you may not use this file except in compliance
8 | * with the License. You may obtain a copy of the License at
9 | *
10 | * http://www.apache.org/licenses/LICENSE-2.0
11 | *
12 | * Unless required by applicable law or agreed to in writing,
13 | * software distributed under the License is distributed on an
14 | * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
15 | * KIND, either express or implied. See the License for the
16 | * specific language governing permissions and limitations
17 | * under the License.
18 | */
19 |
20 | package com.ibm.mqlight.api.impl.logging.logback;
21 |
22 | import ch.qos.logback.classic.pattern.ClassicConverter;
23 | import ch.qos.logback.classic.spi.ILoggingEvent;
24 |
25 | /**
26 | * A logback converter to support a thread id customer conversion specifier.
27 | */
28 | public class TIDConverter extends ClassicConverter {
29 |
30 | @Override
31 | public String convert(ILoggingEvent event) {
32 | return String.format("%04d", Thread.currentThread().getId());
33 | }
34 |
35 | }
36 |
--------------------------------------------------------------------------------
/mqlight/src/main/java/com/ibm/mqlight/api/impl/logging/logback/TraceFilter.java:
--------------------------------------------------------------------------------
1 | /**
2 | * Licensed to the Apache Software Foundation (ASF) under one
3 | * or more contributor license agreements. See the NOTICE file
4 | * distributed with this work for additional information
5 | * regarding copyright ownership. The ASF licenses this file
6 | * to you under the Apache License, Version 2.0 (the
7 | * "License"); you may not use this file except in compliance
8 | * with the License. You may obtain a copy of the License at
9 | *
10 | * http://www.apache.org/licenses/LICENSE-2.0
11 | *
12 | * Unless required by applicable law or agreed to in writing,
13 | * software distributed under the License is distributed on an
14 | * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
15 | * KIND, either express or implied. See the License for the
16 | * specific language governing permissions and limitations
17 | * under the License.
18 | */
19 |
20 | package com.ibm.mqlight.api.impl.logging.logback;
21 |
22 | import java.util.HashMap;
23 | import java.util.Map;
24 |
25 | import org.slf4j.Marker;
26 |
27 | import com.ibm.mqlight.api.impl.logging.LogMarker;
28 |
29 | import ch.qos.logback.classic.spi.ILoggingEvent;
30 | import ch.qos.logback.core.filter.Filter;
31 | import ch.qos.logback.core.spi.FilterReply;
32 |
33 | /**
34 | * A logback filter for selecting MQ Light trace type events. These are events that have been marked as entry, exit, data or throwing.
35 | */
36 | public class TraceFilter extends Filter
37 | * Once the buffer is finished with the {@link ByteBuf#release()}
38 | * method must be called to return the buffer to the pool, otherwise
39 | * a memory leak will eventually be reported by the
40 | * {@link io.netty.util.ResourceLeakDetector}.
41 | */
42 | void onRead(NetworkChannel channel, ByteBuf buffer);
43 |
44 | /**
45 | * Called when the network connection is closed at the remote end.
46 | * @param channel identifies which network connections was closed.
47 | */
48 | void onClose(NetworkChannel channel);
49 |
50 | /**
51 | * Called when an error occurs on the network connection - for example because
52 | * the process at the remote end of the connection abruptly ends.
53 | * @param channel identifies which network connection the error relates to.
54 | * @param exception an exception relating to the error condition.
55 | */
56 | void onError(NetworkChannel channel, Exception exception);
57 | }
58 |
--------------------------------------------------------------------------------
/mqlight/src/main/java/com/ibm/mqlight/api/network/NetworkService.java:
--------------------------------------------------------------------------------
1 | /**
2 | * Licensed to the Apache Software Foundation (ASF) under one
3 | * or more contributor license agreements. See the NOTICE file
4 | * distributed with this work for additional information
5 | * regarding copyright ownership. The ASF licenses this file
6 | * to you under the Apache License, Version 2.0 (the
7 | * "License"); you may not use this file except in compliance
8 | * with the License. You may obtain a copy of the License at
9 | *
10 | * http://www.apache.org/licenses/LICENSE-2.0
11 | *
12 | * Unless required by applicable law or agreed to in writing,
13 | * software distributed under the License is distributed on an
14 | * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
15 | * KIND, either express or implied. See the License for the
16 | * specific language governing permissions and limitations
17 | * under the License.
18 | */
19 | package com.ibm.mqlight.api.network;
20 |
21 | import com.ibm.mqlight.api.NonBlockingClient;
22 | import com.ibm.mqlight.api.Promise;
23 | import com.ibm.mqlight.api.endpoint.Endpoint;
24 |
25 | /**
26 | * Plug point for network implementations. The implementation used for an
27 | * instance of the client can be specified using the
28 | * {@link NonBlockingClient#create(com.ibm.mqlight.api.endpoint.EndpointService, com.ibm.mqlight.api.callback.CallbackService, com.ibm.mqlight.api.network.NetworkService, com.ibm.mqlight.api.timer.TimerService, com.google.gson.GsonBuilder, com.ibm.mqlight.api.ClientOptions, com.ibm.mqlight.api.NonBlockingClientListener, Object)}
29 | * method.
30 | */
31 | public interface NetworkService {
32 |
33 | /**
34 | * Establish a network connection.
35 | * @param endpoint provides information about the host, port, etc. to establish the network
36 | * connection to.
37 | * @param listener a listener that will be notified of network connection related events.
38 | * The listener will only be used if the network connection is successfully
39 | * established.
40 | * @param promise a promise to complete when the outcome of the network connection attempt is
41 | * established. If the network connection is successfully established then the
42 | * {@link Promise#setSuccess(Object)} is passed an implementation of
43 | * {@link NetworkChannel} that can be used to send data over the network connection.
44 | */
45 | void connect(Endpoint endpoint, NetworkListener listener, Promise
38 | * The implementation cannot block the calling thread - and so must employ some scheme
39 | * that uses another thread to complete the promise.
40 | *
41 | * @param delay a delay in milliseconds
42 | * @param promise a promise object to be completed after the delay period
43 | */
44 | void schedule(long delay, Promise
52 | * Once a promise has been scheduled, using the {@link TimerService#schedule(long, Promise)}
53 | * it will always be completed - even if it is cancelled as a result of this method
54 | * being invoked.
55 | *
56 | * If this method is invoked on a promise which has already completed, it should have no
57 | * effect.
58 | *
59 | * @param promise the promise to cancel
60 | */
61 | void cancel(Promisestopped state.
43 | *
44 | * @param promise a promise that is to be completed when the endpoint service has
45 | * completed the lookup request.
46 | */
47 | void lookup(EndpointPromise promise);
48 |
49 | /**
50 | * Called by the client when it has successfully established a connection to one of
51 | * the endpoints returned by this service. This allows the endpoint service to
52 | * optimise the order in which it returns endpoints (for example to implement an
53 | * algorithm that always returns the most recently successful endpoints first).
54 | *
55 | * @param endpoint the endpoint to which a connection has successfully being established.
56 | */
57 | void onSuccess(Endpoint endpoint);
58 | }
59 |
--------------------------------------------------------------------------------
/mqlight/src/main/java/com/ibm/mqlight/api/impl/BytesDeliveryImpl.java:
--------------------------------------------------------------------------------
1 | /**
2 | * Licensed to the Apache Software Foundation (ASF) under one
3 | * or more contributor license agreements. See the NOTICE file
4 | * distributed with this work for additional information
5 | * regarding copyright ownership. The ASF licenses this file
6 | * to you under the Apache License, Version 2.0 (the
7 | * "License"); you may not use this file except in compliance
8 | * with the License. You may obtain a copy of the License at
9 | *
10 | * http://www.apache.org/licenses/LICENSE-2.0
11 | *
12 | * Unless required by applicable law or agreed to in writing,
13 | * software distributed under the License is distributed on an
14 | * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
15 | * KIND, either express or implied. See the License for the
16 | * specific language governing permissions and limitations
17 | * under the License.
18 | */
19 | package com.ibm.mqlight.api.impl;
20 |
21 | import java.nio.ByteBuffer;
22 | import java.util.Map;
23 |
24 | import com.ibm.mqlight.api.BytesDelivery;
25 | import com.ibm.mqlight.api.QOS;
26 | import com.ibm.mqlight.api.impl.engine.DeliveryRequest;
27 |
28 | class BytesDeliveryImpl extends DeliveryImpl implements BytesDelivery {
29 |
30 | private final ByteBuffer data;
31 |
32 | protected BytesDeliveryImpl(NonBlockingClientImpl client, QOS qos, String shareName, String topic,
33 | String topicPattern, long ttl, ByteBuffer data, Mapnull if no value has yet been set.
52 | * @return the context object (if any) set using {@link NetworkChannel#setContext(Object)}
53 | */
54 | Object getContext();
55 | }
56 |
--------------------------------------------------------------------------------
/mqlight/src/main/java/com/ibm/mqlight/api/network/NetworkListener.java:
--------------------------------------------------------------------------------
1 | /**
2 | * Licensed to the Apache Software Foundation (ASF) under one
3 | * or more contributor license agreements. See the NOTICE file
4 | * distributed with this work for additional information
5 | * regarding copyright ownership. The ASF licenses this file
6 | * to you under the Apache License, Version 2.0 (the
7 | * "License"); you may not use this file except in compliance
8 | * with the License. You may obtain a copy of the License at
9 | *
10 | * http://www.apache.org/licenses/LICENSE-2.0
11 | *
12 | * Unless required by applicable law or agreed to in writing,
13 | * software distributed under the License is distributed on an
14 | * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
15 | * KIND, either express or implied. See the License for the
16 | * specific language governing permissions and limitations
17 | * under the License.
18 | */
19 | package com.ibm.mqlight.api.network;
20 |
21 | import io.netty.buffer.ByteBuf;
22 |
23 | /**
24 | * A listener for events that occur on a particular network channel.
25 | */
26 | public interface NetworkListener {
27 |
28 | /**
29 | * Called when data is read from the network.
30 | * @param channel identifies which network connection the data was
31 | * read from.
32 | * @param buffer contains the data that has been read. The buffer belongs
33 | * to the implementation of this method - and will not be
34 | * altered by the implementation of {@link NetworkService} once
35 | * this method has been invoked.
36 | *