/* * JBoss, Home of Professional Open Source * Copyright 2010 Red Hat Inc. and/or its affiliates and other * contributors as indicated by the @author tags. All rights reserved. * See the copyright.txt in the distribution for a full listing of * individual contributors. * * This is free software; you can redistribute it and/or modify it * under the terms of the GNU Lesser General Public License as * published by the Free Software Foundation; either version 2.1 of * the License, or (at your option) any later version. * * This software is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this software; if not, write to the Free * Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA * 02110-1301 USA, or see the FSF site: http://www.fsf.org. */ package org.infinispan.client.hotrod.impl.operations; import java.util.concurrent.atomic.AtomicInteger; import net.jcip.annotations.Immutable; import org.infinispan.client.hotrod.exceptions.HotRodClientException; import org.infinispan.client.hotrod.impl.protocol.Codec; import org.infinispan.client.hotrod.impl.protocol.HeaderParams; import org.infinispan.client.hotrod.impl.protocol.HotRodConstants; import org.infinispan.client.hotrod.impl.transport.Transport; import org.infinispan.util.logging.BasicLogFactory; import org.jboss.logging.BasicLogger; /** * Corresponds to the "ping" operation as defined in <a href="http://community.jboss.org/wiki/HotRodProtocol">Hot Rod protocol specification</a>. * * @author Mircea.Markus@jboss.com * @since 4.1 */ @Immutable public class PingOperation extends HotRodOperation { private static final BasicLogger log = BasicLogFactory.getLog(PingOperation.class); private final Transport transport; public PingOperation(Codec codec, AtomicInteger topologyId, Transport transport) { this(codec, topologyId, transport, DEFAULT_CACHE_NAME_BYTES); } public PingOperation(Codec codec, AtomicInteger topologyId, Transport transport, byte[] cacheName) { super(codec, null, cacheName, topologyId); this.transport = transport; } @Override public PingResult execute() { try { HeaderParams params = writeHeader(transport, HotRodConstants.PING_REQUEST); transport.flush(); short respStatus = readHeaderAndValidate(transport, params); if (respStatus == HotRodConstants.NO_ERROR_STATUS) { if (log.isTraceEnabled()) log.tracef("Successfully validated transport: %s", transport); return PingResult.SUCCESS; } else { if (log.isTraceEnabled()) log.tracef("Unknown response status: %s", respStatus); return PingResult.FAIL; } } catch (HotRodClientException e) { if (e.getMessage().contains("CacheNotFoundException")) return PingResult.CACHE_DOES_NOT_EXIST; else return PingResult.FAIL; } catch (Exception e) { if (log.isTraceEnabled()) log.tracef(e, "Failed to validate transport: %s", transport); return PingResult.FAIL; } } public static enum PingResult { // Success if the ping request was responded correctly SUCCESS, // When the ping request fails due to non-existing cache CACHE_DOES_NOT_EXIST, // For any other type of failures FAIL, } }