/*
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance
* with the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package com.sun.jini.test.spec.jeri.basicinvocationdispatcher;
import java.util.logging.Level;
import com.sun.jini.test.spec.jeri.util.FakeInboundRequest;
import java.util.logging.Level;
import java.lang.reflect.UndeclaredThrowableException;
/**
* <pre>
* Purpose
* This test verifies the behavior of the BasicInvocationDispatcher.dispatch
* method when an exception (possibly wrapped) is thrown by the
* BasicInvocationDispatcher.checkAccess method.
*
* Test Cases
* This test iterates over a set of exceptions. Each exception
* denotes one test case and is defined by the variable:
* Throwable checkAccessException
*
* Infrastructure
* This test requires the following infrastructure:
* 1) FakeRemoteImpl
* -implements Remote
* -a class which declares one method that throws RemoteException
* 2) FakeInboundRequest
* -constructor takes four parameters (first 2 bytes, method hash,
* and arguments) and writes them to request stream
* -abort method does nothing
* -checkConstraints does nothing
* -checkPermissions does nothing
* -populateContext does nothing
* -getClientHost returns local host name
* -getRequestInputStream and getResponseOutputStream methods
* return streams created in constructor
* 3) FakeServerCapabilities
* -checkConstraints method returns InvocationConstraints.EMPTY
* 4) FakeBasicInvocationDispatcher
* -subclasses BasicInvocationDispatcher
* -overloaded checkAccess method can throw a configurable exception
*
* Actions
* For each test case the test performs the following steps:
* 1) construct a FakeRemoteImpl and FakeServerCapabilities
* 2) construct a FakeBasicInvocationDispatcher, passing in
* checkAccessException
* 3) construct a FakeInboundRequest, passing in method hash of
* FakeRemoteImpl's method
* 4) call FakeBasicInvocationDispatcher.dispatch with FakeRemoteImpl,
* FakeInboundRequest, and an empty context
* 5) assert FakeInboundRequest response stream returns the byte 0x02
* and the properly wrapped exception checkAccessException
* </pre>
*/
public class Dispatch_CheckAccessExceptionTest extends AbstractDispatcherTest {
// test cases
Throwable[] cases = {
new SecurityException(), //RuntimeException subclass
new ArrayIndexOutOfBoundsException(), //RuntimeException subclass
new UndeclaredThrowableException(null), //RuntimeException subclass
new NullPointerException(), //RuntimeException subclass
new IllegalStateException(), //RuntimeException subclass
new LinkageError(), //Error subclass
new AssertionError(), //Error subclass
};
// inherit javadoc
public void run() throws Exception {
// iterate over test cases
for (int i = 0; i < cases.length; i++) {
logger.log(Level.FINE,"=================================");
Throwable checkAccessException = cases[i];
logger.log(Level.FINE,"test case " + (counter++)
+ ": checkAccess exception: " + checkAccessException);
logger.log(Level.FINE,"");
// initialize FakeInboundRequest
request = new FakeInboundRequest(methodHash,nullArgs,0x00,0x00);
// initialize FakeBasicInvocationDispatcher
dispatcher.setCheckAccessException(checkAccessException);
// call dispatch and verify the proper result
dispatcher.dispatch(impl,request,context);
response = request.getResponseStream();
assertion(response.read() == 0x02);
checkUnmarshallingException(checkAccessException, response);
}
}
}