Add server.control(). Closes #3767

API.md

@@ -1,4 +1,4 @@
-# v17.2.x API Reference
+# v17.3.x API Reference
 
 <!-- toc -->
 
@@ -58,6 +58,7 @@
   - [`server.bind(context)`](#server.bind())
   - [`server.cache(options)`](#server.cache())
   - [`await server.cache.provision(options)`](#server.cache.provision())
+  - [`server.control(server)`](#server.control())
   - [`server.decoder(encoding, decoder)`](#server.decoder())
   - [`server.decorate(type, property, method, [options])`](#server.decorate())
   - [`server.dependency(dependencies, [after])`](#server.dependency())
@@ -1424,6 +1425,14 @@ async function example() {
 }
 ```
 
+### <a name="server.control()" /> `server.control(server)`
+
+Links another server to the initialize/start/stop state of the current server by calling the
+controlled server `initialize()`/`start()`/`stop()` methods whenever the current server methods
+are called, where:
+
+- `server` - the **hapi** server object to be controlled.
+
 ### <a name="server.decoder()" /> `server.decoder(encoding, decoder)`
 
 Registers a custom content decoding compressor to extend the built-in support for `'gzip'` and

LICENSE

@@ -1,4 +1,4 @@
-Copyright (c) 2011-2017, Project contributors
+Copyright (c) 2011-2018, Project contributors
 Copyright (c) 2011-2014, Walmart
 Copyright (c) 2011, Yahoo Inc.
 All rights reserved.

README.md

@@ -10,7 +10,7 @@ developers to focus on writing reusable application logic in a highly modular an
 
 Version 17.x only supports node v8.9.0 and over. For older version of node please use version 16.x.
 
-Development version: **17.1.x** ([release notes](https://github.com/hapijs/hapi/issues?labels=release+notes&page=1&state=closed)) 
+Development version: **17.3.x** ([release notes](https://github.com/hapijs/hapi/issues?labels=release+notes&page=1&state=closed)) 
 [![Build Status](https://secure.travis-ci.org/hapijs/hapi.svg?branch=master)](http://travis-ci.org/hapijs/hapi)
 
 For the latest updates, [change log](http://hapijs.com/updates), and release information visit [hapijs.com](http://hapijs.com) and follow [@hapijs](https://twitter.com/hapijs) on twitter. If you have questions, please open an issue in the

lib/core.js

@@ -63,6 +63,7 @@ exports = module.exports = internals.Core = class {
         this.auth = new Auth(this);
         this.caches = new Map();                                                        // Cache clients
         this.compression = new Compression();
+        this.controlled = null;                                                         // Other servers linked to the phases of this server
         this.decorations = { handler: [], request: [], server: [], toolkit: [] };       // Public decoration names
         this.dependencies = [];                                                         // Plugin dependencies
         this.events = new Podium(internals.events);
@@ -251,6 +252,10 @@ exports = module.exports = internals.Core = class {
         await this.events.emit('start');
 
         try {
+            if (this.controlled) {
+                await Promise.all(this.controlled.map((control) => control.start()));
+            }
+
             await this._invoke('onPostStart');
         }
         catch (err) {
@@ -319,6 +324,10 @@ exports = module.exports = internals.Core = class {
             await this._invoke('onPreStart');
             this.heavy.start();
             this.phase = 'initialized';
+
+            if (this.controlled) {
+                await Promise.all(this.controlled.map((control) => control.initialize()));
+            }
         }
         catch (err) {
             this.phase = 'invalid';
@@ -365,6 +374,11 @@ exports = module.exports = internals.Core = class {
 
             await this.events.emit('stop');
             this.heavy.stop();
+
+            if (this.controlled) {
+                await Promise.all(this.controlled.map((control) => control.stop(options)));
+            }
+
             await this._invoke('onPostStop');
             this.phase = 'stopped';
         }

lib/server.js

@@ -99,6 +99,14 @@ internals.Server = class {
         this.realm.settings.bind = context;
     }
 
+    control(server) {
+
+        Hoek.assert(server instanceof internals.Server, 'Can only control Server objects');
+
+        this._core.controlled = this._core.controlled || [];
+        this._core.controlled.push(server);
+    }
+
     decoder(encoding, decoder) {
 
         return this._core.compression.addDecoder(encoding, decoder);