com.sun.gjc.spi.ResourceAdapterImpl Maven / Gradle / Ivy
/*
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
*
* Copyright (c) 1997-2011 Oracle and/or its affiliates. All rights reserved.
*
* The contents of this file are subject to the terms of either the GNU
* General Public License Version 2 only ("GPL") or the Common Development
* and Distribution License("CDDL") (collectively, the "License"). You
* may not use this file except in compliance with the License. You can
* obtain a copy of the License at
* https://glassfish.dev.java.net/public/CDDL+GPL_1_1.html
* or packager/legal/LICENSE.txt. See the License for the specific
* language governing permissions and limitations under the License.
*
* When distributing the software, include this License Header Notice in each
* file and include the License file at packager/legal/LICENSE.txt.
*
* GPL Classpath Exception:
* Oracle designates this particular file as subject to the "Classpath"
* exception as provided by Oracle in the GPL Version 2 section of the License
* file that accompanied this code.
*
* Modifications:
* If applicable, add the following below the License Header, with the fields
* enclosed by brackets [] replaced by your own identifying information:
* "Portions Copyright [year] [name of copyright owner]"
*
* Contributor(s):
* If you wish your version of this file to be governed by only the CDDL or
* only the GPL Version 2, indicate your decision by adding "[Contributor]
* elects to include this software in this distribution under the [CDDL or GPL
* Version 2] license." If you don't indicate a single choice of license, a
* recipient has the option to distribute your version of this file under
* either the CDDL, the GPL Version 2 or to extend the choice of license to
* its licensees as provided above. However, if you add GPL Version 2 code
* and therefore, elected the GPL Version 2 license, then the option applies
* only if the new code is made subject to such option by the copyright
* holder.
*/
// Portions Copyright [2018-2021] Payara Foundation and/or affiliates
package com.sun.gjc.spi;
import com.sun.enterprise.util.Utility;
import com.sun.logging.LogDomains;
import java.security.AccessController;
import java.security.PrivilegedActionException;
import java.security.PrivilegedExceptionAction;
import java.util.Timer;
import java.util.logging.Level;
import java.util.logging.Logger;
import jakarta.resource.NotSupportedException;
import jakarta.resource.spi.ActivationSpec;
import jakarta.resource.spi.AuthenticationMechanism;
import jakarta.resource.spi.BootstrapContext;
import jakarta.resource.spi.Connector;
import jakarta.resource.spi.endpoint.MessageEndpointFactory;
import javax.transaction.xa.XAResource;
/**
* ResourceAdapterImpl implementation for Generic JDBC Connector.
*
* @author Evani Sai Surya Kiran
* @version 1.0, 02/08/05
*/
@Connector(
description = "Resource adapter wrapping implementation of driver",
displayName = "Resource Adapter",
vendorName = "Sun Microsystems",
eisType = "Database",
version = "1.0",
authMechanisms = {
@AuthenticationMechanism(authMechanism="BasicPassword",
credentialInterface=AuthenticationMechanism.CredentialInterface.PasswordCredential)
}
)
public class ResourceAdapterImpl implements jakarta.resource.spi.ResourceAdapter {
private static ResourceAdapterImpl ra;
private BootstrapContext bootstrapContext;
private Timer timer;
private static Logger _logger = LogDomains.getLogger(ResourceAdapterImpl.class, LogDomains.RSR_LOGGER);
public ResourceAdapterImpl() {
if(ra == null){
//we do not expect RA to be initialized multiple times as this is a System RAR
ra = this;
}
}
public static ResourceAdapterImpl getInstance() {
if(ra == null) {
throw new IllegalStateException("ResourceAdapter not initialized");
}
return ra;
}
/**
* Empty method implementation for endpointActivation
* which just throws NotSupportedException
*
* @param mef MessageEndpointFactory
* @param as ActivationSpec
* @throws NotSupportedException
*
*/
@Override
public void endpointActivation(MessageEndpointFactory mef, ActivationSpec as) throws NotSupportedException {
throw new NotSupportedException("This method is not supported for this JDBC connector");
}
/**
* Empty method implementation for endpointDeactivation
*
* @param mef MessageEndpointFactory
* @param as ActivationSpec
*/
@Override
public void endpointDeactivation(MessageEndpointFactory mef, ActivationSpec as) {
}
/**
* Empty method implementation for getXAResources
* which just throws NotSupportedException
*
* @param specs ActivationSpec array
* @throws NotSupportedException
*
*/
@Override
public XAResource[] getXAResources(ActivationSpec[] specs) throws NotSupportedException {
throw new NotSupportedException("This method is not supported for this JDBC connector");
}
/**
* Empty implementation of start method
*
* @param ctx BootstrapContext
*/
@Override
public void start(BootstrapContext ctx) {
this.bootstrapContext = ctx;
}
/**
* Empty implementation of stop method
*/
@Override
public void stop() {
if(_logger.isLoggable(Level.FINEST)) {
_logger.finest("Cancelling the timer");
}
if(timer != null) {
timer.purge();
timer.cancel();
}
}
public Timer getTimer() {
if(bootstrapContext != null) {
if (timer == null) {
if(_logger.isLoggable(Level.FINEST)) {
_logger.finest("Creating the timer");
}
ClassLoader appClassLoader = Utility.getClassLoader();
// do not propagate application class loader to the timer thread
// may cause memory leaks
Utility.setContextClassLoader(null);
try {
timer = AccessController.doPrivileged((PrivilegedExceptionAction) bootstrapContext::createTimer);
} catch (PrivilegedActionException ex) {
_logger.log(Level.SEVERE, "jdbc-ra.timer_creation_exception", ex.getCause().getMessage());
} finally {
Utility.setContextClassLoader(appClassLoader);
}
}
}
return timer;
}
}