/* * Copyright 2019 gRPC authors. * * Licensed 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. * */ // Allow `any` data type for testing runtime type checking. // tslint:disable no-any import * as assert from 'assert'; import * as fs from 'fs'; import * as path from 'path'; import {ServerCredentials} from '../src'; import {Server} from '../src/server'; import {loadProtoFile} from './common'; const ca = fs.readFileSync(path.join(__dirname, 'fixtures', 'ca.pem')); const key = fs.readFileSync(path.join(__dirname, 'fixtures', 'server1.key')); const cert = fs.readFileSync(path.join(__dirname, 'fixtures', 'server1.pem')); function noop(): void {} describe('Server', () => { describe('constructor', () => { it('should work with no arguments', () => { assert.doesNotThrow(() => { new Server(); // tslint:disable-line:no-unused-expression }); }); it('should work with an empty object argument', () => { assert.doesNotThrow(() => { new Server({}); // tslint:disable-line:no-unused-expression }); }); it('should be an instance of Server', () => { const server = new Server(); assert(server instanceof Server); }); }); describe('bindAsync', () => { it('binds with insecure credentials', (done) => { const server = new Server(); server.bindAsync( 'localhost:0', ServerCredentials.createInsecure(), (err, port) => { assert.ifError(err); assert(typeof port === 'number' && port > 0); server.tryShutdown(done); }); }); it('binds with secure credentials', (done) => { const server = new Server(); const creds = ServerCredentials.createSsl( ca, [{private_key: key, cert_chain: cert}], true); server.bindAsync('localhost:0', creds, (err, port) => { assert.ifError(err); assert(typeof port === 'number' && port > 0); server.tryShutdown(done); }); }); it('throws if bind is called after the server is started', () => { const server = new Server(); server.bindAsync( 'localhost:0', ServerCredentials.createInsecure(), (err, port) => { assert.ifError(err); server.start(); assert.throws(() => { server.bindAsync( 'localhost:0', ServerCredentials.createInsecure(), noop); }, /server is already started/); }); }); it('throws on invalid inputs', () => { const server = new Server(); assert.throws(() => { server.bindAsync(null as any, ServerCredentials.createInsecure(), noop); }, /port must be a string/); assert.throws(() => { server.bindAsync('localhost:0', null as any, noop); }, /creds must be an object/); assert.throws(() => { server.bindAsync( 'localhost:0', ServerCredentials.createInsecure(), null as any); }, /callback must be a function/); }); }); describe('tryShutdown', () => { it('calls back with an error if the server is not running', (done) => { const server = new Server(); server.tryShutdown((err) => { assert(err !== undefined && err.message === 'server is not running'); done(); }); }); }); describe('start', () => { let server: Server; beforeEach((done) => { server = new Server(); server.bindAsync('localhost:0', ServerCredentials.createInsecure(), done); }); afterEach((done) => { server.tryShutdown(done); }); it('starts without error', () => { assert.doesNotThrow(() => { server.start(); }); }); it('throws if started twice', () => { server.start(); assert.throws(() => { server.start(); }, /server is already started/); }); it('throws if the server is not bound', () => { const server = new Server(); assert.throws(() => { server.start(); }, /server must be bound in order to start/); }); }); describe('addService', () => { const mathProtoFile = path.join(__dirname, 'fixtures', 'math.proto'); const mathClient = (loadProtoFile(mathProtoFile).math as any).Math; const mathServiceAttrs = mathClient.service; const dummyImpls = {div() {}, divMany() {}, fib() {}, sum() {}}; const altDummyImpls = {Div() {}, DivMany() {}, Fib() {}, Sum() {}}; it('succeeds with a single service', () => { const server = new Server(); assert.doesNotThrow(() => { server.addService(mathServiceAttrs, dummyImpls); }); }); it('fails to add an empty service', () => { const server = new Server(); assert.throws(() => { server.addService({}, dummyImpls); }, /Cannot add an empty service to a server/); }); it('fails with conflicting method names', () => { const server = new Server(); server.addService(mathServiceAttrs, dummyImpls); assert.throws(() => { server.addService(mathServiceAttrs, dummyImpls); }, /Method handler for .+ already provided/); }); it('supports method names as originally written', () => { const server = new Server(); assert.doesNotThrow(() => { server.addService(mathServiceAttrs, altDummyImpls); }); }); it('fails if the server has been started', (done) => { const server = new Server(); server.bindAsync( 'localhost:0', ServerCredentials.createInsecure(), (err, port) => { assert.ifError(err); server.start(); assert.throws(() => { server.addService(mathServiceAttrs, dummyImpls); }, /Can't add a service to a started server\./); server.tryShutdown(done); }); }); }); it('throws when unimplemented methods are called', () => { const server = new Server(); assert.throws(() => { server.addProtoService(); }, /Not implemented. Use addService\(\) instead/); assert.throws(() => { server.forceShutdown(); }, /Not yet implemented/); assert.throws(() => { server.addHttp2Port(); }, /Not yet implemented/); assert.throws(() => { server.bind('localhost:0', ServerCredentials.createInsecure()); }, /Not implemented. Use bindAsync\(\) instead/); }); });