Application.cpp 35 KB
Newer Older
legoc's avatar
legoc committed
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
/*
 * Copyright 2015 Institut Laue-Langevin
 *
 * Licensed under the EUPL, Version 1.1 only (the "License");
 * You may not use this work except in compliance with the Licence.
 * You may obtain a copy of the Licence at:
 *
 * http://joinup.ec.europa.eu/software/page/eupl
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the Licence is distributed on an "AS IS" basis,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the Licence for the specific language governing permissions and
 * limitations under the Licence.
 */

17
#include "Application.h"
legoc's avatar
legoc committed
18
19
20
21
22
23

#include <sstream>
#include <iostream>
#include <iostream>
#include <stdexcept>
#include <vector>
24
25

#include "JSON.h"
26
#include "EventStreamSocket.h"
27
#include "impl/ServicesImpl.h"
28
29
30
31
32
33
34
#include "impl/PublisherImpl.h"
#include "impl/RequesterImpl.h"
#include "impl/RequestImpl.h"
#include "impl/ResponderImpl.h"
#include "impl/SubscriberImpl.h"
#include "impl/WaitingImpl.h"
#include "impl/WaitingImplSet.h"
35
#include "impl/HandlerImpl.h"
36
#include "impl/StreamSocketImpl.h"
legoc's avatar
legoc committed
37
#include "impl/RequestSocketImpl.h"
38
#include "message/Message.h"
39
#include "Strings.h"
40
41
42
#include "Server.h"
#include "StarterServerException.h"
#include "StatusEvent.h"
43
44
45
#include "PublisherEvent.h"
#include "ResultEvent.h"
#include "PortEvent.h"
46
#include "KeyEvent.h"
47
#include "CancelEvent.h"
legoc's avatar
legoc committed
48
49
50
51
52
53

using namespace std;

namespace cameo {
namespace application {

54
This This::m_instance;
legoc's avatar
legoc committed
55
56
const std::string This::RUNNING_STATE = "RUNNING";

57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
This::Com::Com(Server * server, int applicationId) :
	m_server(server),
	m_applicationId(applicationId) {
}

void This::Com::storeKeyValue(const std::string& key, const std::string& value) const {
	m_server->storeKeyValue(m_applicationId, key, value);
}
std::string This::Com::getKeyValue(const std::string& key) const {
	return m_server->getKeyValue(m_applicationId, key);
}

void This::Com::removeKey(const std::string& key) const {
	m_server->removeKey(m_applicationId, key);
}

73
74
75
76
77
78
79
80
81
82
83
84
int This::Com::requestPort() const {
	return m_server->requestPort(m_applicationId);
}

void This::Com::setPortUnavailable(int port) const {
	m_server->setPortUnavailable(m_applicationId, port);
}

void This::Com::releasePort(int port) const {
	m_server->releasePort(m_applicationId, port);
}

legoc's avatar
legoc committed
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
State This::parseState(const std::string& value) {

	if (value == "UNKNOWN") {
		return UNKNOWN;
	} else if (value == "STARTING") {
		return STARTING;
	} else if (value == "RUNNING") {
		return RUNNING;
	} else if (value == "STOPPING") {
		return STOPPING;
	} else if (value == "KILLING") {
		return KILLING;
	} else if (value == "PROCESSING_ERROR") {
		return PROCESSING_ERROR;
	} else if (value == "ERROR") {
legoc's avatar
legoc committed
100
		return FAILURE;
legoc's avatar
legoc committed
101
102
103
104
105
106
107
108
109
110
111
112
	} else if (value == "SUCCESS") {
		return SUCCESS;
	} else if (value == "STOPPED") {
		return STOPPED;
	} else if (value == "KILLED") {
		return KILLED;
	}

	return UNKNOWN;
}

void This::init(int argc, char *argv[]) {
legoc's avatar
legoc committed
113
	if (m_instance.m_impl == nullptr) {
114
		m_instance.initApplication(argc, argv);
legoc's avatar
legoc committed
115
116
117
118
	}
}

std::string This::getReference() {
legoc's avatar
legoc committed
119
	if (m_instance.m_impl != nullptr) {
legoc's avatar
legoc committed
120
		ostringstream os;
121
		os << getName() << "." << getId() << "@" << getEndpoint();
legoc's avatar
legoc committed
122
123
124
125
126
127
		return os.str();
	}
	return "";
}

void This::terminate() {
128
129

	// Test if termination is already done.
legoc's avatar
legoc committed
130
	if (m_instance.m_impl == nullptr) {
131
132
133
134
135
136
		return;
	}

	// Terminate the unmanaged application.
	if (!m_instance.m_managed) {
		m_instance.terminateUnmanagedApplication();
legoc's avatar
legoc committed
137
138
	}

139
140
141
142
	// Terminate the services.
	m_instance.Services::terminate();

	// Ensure that it won't be done twice.
legoc's avatar
legoc committed
143
	m_instance.m_impl = nullptr;
legoc's avatar
legoc committed
144
145
}

146
147

This::This() :
legoc's avatar
legoc committed
148
	Services(),
legoc's avatar
legoc committed
149
150
151
	m_id(-1),
	m_managed(false),
	m_starterId(0) {
152
153
154
}

void This::initApplication(int argc, char *argv[]) {
legoc's avatar
legoc committed
155

156
	Services::init();
legoc's avatar
legoc committed
157
158

	if (argc == 0) {
159
		throw InvalidArgumentException("missing info argument");
legoc's avatar
legoc committed
160
161
162
163
	}

	string info(argv[argc - 1]);

164
165
166
167
168
169
170
171
172
173
174
175
176
177
//	vector<string> tokens = split(info);
//
//	if (tokens.size() < 4) {
//		throw InvalidArgumentException(info + " is not a valid argument");
//	}
//
//	m_url = tokens[0] + ":" + tokens[1];
//
//	string port = tokens[2];
//	istringstream is(port);
//	is >> m_port;

	json::Object infoObject;
	json::parse(infoObject, info);
legoc's avatar
legoc committed
178

179
	Endpoint endpoint = Endpoint::parse(infoObject[message::ApplicationIdentity::SERVER].GetString());
legoc's avatar
legoc committed
180

181
182
	m_url = endpoint.getProtocol() + "://" + endpoint.getAddress();
	m_port = endpoint.getPort();
legoc's avatar
legoc committed
183

184
185
186
	// We separated host endpoint and server in the past (server being tcp://localhost)
	// but that generates troubles when two applications communicate remotely.
	// However leave the same value seems to be ok.
187
	m_serverEndpoint = m_url + ":" + to_string(m_port);
legoc's avatar
legoc committed
188

189
190
191
	// Create the request socket. The server endpoint has been defined.
	Services::initRequestSocket();

192
193
194
	// Retrieve the server version.
	Services::retrieveServerVersion();

195
196
197
//	string nameId = tokens[3];
//
//	int index = nameId.find_last_of('.');
legoc's avatar
legoc committed
198

199
	m_name = infoObject[message::ApplicationIdentity::NAME].GetString();
legoc's avatar
legoc committed
200

201
202
203
//	// Search for the . character meaning that the application is managed and already has an id.
//	if (index != string::npos) {
	if (infoObject.HasMember(message::ApplicationIdentity::ID)) {
legoc's avatar
legoc committed
204
		m_managed = true;
205
206
207
208
209
210
211
//		m_name = nameId.substr(0, index);
//		string sid = nameId.substr(index + 1);
//		{
//			istringstream is(sid);
//			is >> m_id;
//		}
		m_id = infoObject[message::ApplicationIdentity::ID].GetInt();
legoc's avatar
legoc committed
212
213
214
	}
	else {
		m_managed = false;
215
//		m_name = nameId;
legoc's avatar
legoc committed
216
		m_id = initUnmanagedApplication();
217
218
219
220

		if (m_id == -1) {
			throw UnmanagedApplicationException(string("Maximum number of applications ") + m_name + " reached");
		}
legoc's avatar
legoc committed
221
222
	}

223
224
225
226
227
228
229
230
231
232
233
234
//	if (tokens.size() >= 7) {
//		index = tokens[4].find_last_of('@');
//		m_starterEndpoint = tokens[4].substr(index + 1) + ":" + tokens[5] + ":" + tokens[6];
//		string starterNameId = tokens[4].substr(0, index);
//		index = starterNameId.find_last_of('.');
//		m_starterName = starterNameId.substr(0, index);
//		string sid = starterNameId.substr(index + 1);
//		{
//			istringstream is(sid);
//			is >> m_starterId;
//		}
//	}
legoc's avatar
legoc committed
235

legoc's avatar
legoc committed
236
237
	// Must be here because the server endpoint is required.
	initStatus();
legoc's avatar
legoc committed
238
239

	// Create the local server
legoc's avatar
legoc committed
240
	m_server = unique_ptr<Server>(new Server(m_serverEndpoint));
legoc's avatar
legoc committed
241
242
243

	// Create the starter server
	if (m_starterEndpoint != "") {
legoc's avatar
legoc committed
244
		m_starterServer = unique_ptr<Server>(new Server(m_starterEndpoint));
legoc's avatar
legoc committed
245
246
	}

legoc's avatar
legoc committed
247
	m_waitingSet = unique_ptr<WaitingImplSet>(new WaitingImplSet());
248
249
250
251

	// Init listener.
	setName(m_name);
	m_server->registerEventListener(this);
252
253
254
255


	// Init com.
	m_com = unique_ptr<Com>(new Com(m_server.get(), m_id));
256
257
258
259
260
261
262
263
264


	cout << "url = " << m_url << endl;
	cout << "port = " << m_port << endl;
	cout << "name = " << m_name << endl;
	cout << "id = " << m_id << endl;
	cout << "starterEndpoint = " << m_starterEndpoint << endl;
	cout << "starterName = " << m_starterName << endl;
	cout << "starterId = " << m_starterId << endl;
legoc's avatar
legoc committed
265
266
267
268
}

This::~This() {
	// Do not delete the impl here because there will be order trouble.
269
270

	// Terminate the unmanaged application.
legoc's avatar
legoc committed
271
	if (m_impl != nullptr && !m_managed) {
272
273
		terminateUnmanagedApplication();
	}
legoc's avatar
legoc committed
274
275
276
}

const std::string& This::getName() {
277
	return m_instance.m_name;
legoc's avatar
legoc committed
278
279
280
}

int This::getId() {
281
	return m_instance.m_id;
legoc's avatar
legoc committed
282
283
284
}

void This::setTimeout(int timeout) {
285
	m_instance.Services::setTimeout(timeout);
legoc's avatar
legoc committed
286
287
288
}

int This::getTimeout() {
289
	return m_instance.Services::getTimeout();
legoc's avatar
legoc committed
290
291
}

292
const std::string& This::getEndpoint() {
legoc's avatar
legoc committed
293
	if (m_instance.m_impl != nullptr) {
294
		return m_instance.m_serverEndpoint;
legoc's avatar
legoc committed
295
296
297
298
299
300
	}
	static string result;
	return result;
}

Server& This::getServer() {
301
	return *m_instance.m_server;
legoc's avatar
legoc committed
302
303
}

304
305
306
307
const This::Com& This::getCom() {
	return *m_instance.m_com;
}

legoc's avatar
legoc committed
308
309
Server& This::getStarterServer() {

legoc's avatar
legoc committed
310
	if (m_instance.m_starterServer.get() == nullptr) {
legoc's avatar
legoc committed
311
312
313
		throw StarterServerException();
	}

314
	return *m_instance.m_starterServer;
legoc's avatar
legoc committed
315
316
317
}

const std::string& This::getUrl() {
318
	return m_instance.Services::getUrl();
legoc's avatar
legoc committed
319
320
321
}

bool This::isAvailable(int timeout) {
322
	return m_instance.Services::isAvailable(timeout);
legoc's avatar
legoc committed
323
324
325
}

bool This::isStopping() {
326
	return m_instance.getState(m_instance.m_id) == STOPPING;
legoc's avatar
legoc committed
327
328
329
}

void This::cancelWaitings() {
330
	m_instance.m_waitingSet->cancelAll();
legoc's avatar
legoc committed
331
332
}

legoc's avatar
legoc committed
333
int This::initUnmanagedApplication() {
legoc's avatar
legoc committed
334

335
	unique_ptr<zmq::message_t> reply = m_requestSocket->request(m_impl->createAttachUnmanagedRequest(m_name));
legoc's avatar
legoc committed
336

337
338
339
	// Get the JSON response.
	json::Object response;
	json::parse(response, reply.get());
legoc's avatar
legoc committed
340

341
	return response[message::RequestResponse::VALUE].GetInt();
legoc's avatar
legoc committed
342
343
344
345
}

void This::terminateUnmanagedApplication() {

346
	m_requestSocket->request(m_impl->createDetachUnmanagedRequest(m_id));
legoc's avatar
legoc committed
347
348
}

349
bool This::setRunning() {
legoc's avatar
legoc committed
350

351
	unique_ptr<zmq::message_t> reply = m_instance.m_requestSocket->request(m_instance.m_impl->createSetStatusRequest(m_instance.m_id, RUNNING));
legoc's avatar
legoc committed
352

353
354
355
	// Get the JSON response.
	json::Object response;
	json::parse(response, reply.get());
legoc's avatar
legoc committed
356

357
358
	int value = response[message::RequestResponse::VALUE].GetInt();
	if (value == -1) {
359
		return false;
legoc's avatar
legoc committed
360
	}
361
362

	return true;
legoc's avatar
legoc committed
363
364
365
366
}

void This::setBinaryResult(const std::string& data) {

367
	m_instance.m_requestSocket->request(m_instance.m_impl->createSetResultRequest(m_instance.m_id), data);
legoc's avatar
legoc committed
368
369
370
371
372
373
374
375
376
377
378
}

void This::setResult(const std::string& data) {

	string resultData;
	serialize(data, resultData);
	setBinaryResult(resultData);
}

State This::getState(int id) const {

379
	unique_ptr<zmq::message_t> reply = m_requestSocket->request(m_impl->createGetStatusRequest(id));
legoc's avatar
legoc committed
380

381
382
383
	// Get the JSON response.
	json::Object event;
	json::parse(event, reply.get());
legoc's avatar
legoc committed
384

385
	return event[message::StatusEvent::APPLICATION_STATE].GetInt();
legoc's avatar
legoc committed
386
387
388
389
}

bool This::destroyPublisher(const std::string& name) const {

390
391
392
393
394
	unique_ptr<zmq::message_t> reply = m_requestSocket->request(m_impl->createTerminatePublisherRequest(m_id, name));

	// Get the JSON response.
	json::Object response;
	json::parse(response, reply.get());
legoc's avatar
legoc committed
395

396
	int value = response[message::RequestResponse::VALUE].GetInt();
legoc's avatar
legoc committed
397
398
399
400
401
402

	return (value != -1);
}

bool This::removePort(const std::string& name) const {

403
	unique_ptr<zmq::message_t> reply = m_requestSocket->request(m_impl->createRemovePortV0Request(m_id, name));
legoc's avatar
legoc committed
404

405
406
407
408
409
	// Get the JSON response.
	json::Object response;
	json::parse(response, reply.get());

	int value = response[message::RequestResponse::VALUE].GetInt();
legoc's avatar
legoc committed
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424

	return (value != -1);
}

State This::waitForStop() {

	// test if stop was requested elsewhere
	State state = getState(m_id);
	if (state == STOPPING
		|| state == KILLING) {
		return state;
	}

	while (true) {
		// waits for a new incoming status
425
		unique_ptr<Event> event = popEvent();
legoc's avatar
legoc committed
426
427

		// The socket is canceled.
legoc's avatar
legoc committed
428
		if (event.get() == nullptr) {
legoc's avatar
legoc committed
429
430
431
432
433
434
			return UNKNOWN;
		}

		if (event->getId() == m_id) {
			StatusEvent * status = dynamic_cast<StatusEvent *>(event.get());

legoc's avatar
legoc committed
435
			if (status != nullptr) {
legoc's avatar
legoc committed
436
437
438
439
440
441
442
443
444
445
446
447
448
				state = status->getState();

				if (state == STOPPING
					|| state == KILLING) {
					return state;
				}
			}
		}
	}

	return UNKNOWN;
}

legoc's avatar
legoc committed
449
std::unique_ptr<Instance> This::connectToStarter() {
legoc's avatar
legoc committed
450

legoc's avatar
legoc committed
451
452
	if (m_instance.m_starterServer.get() == nullptr) {
		return unique_ptr<Instance>(nullptr);
legoc's avatar
legoc committed
453
454
455
	}

	// Iterate the instances to find the id
456
	InstanceArray instances = m_instance.m_starterServer->connectAll(m_instance.m_starterName);
legoc's avatar
legoc committed
457
458

	for (int i = 0; i < instances.size(); i++) {
459
		if (instances[i]->getId() == m_instance.m_starterId) {
legoc's avatar
legoc committed
460
			return unique_ptr<Instance>(std::move(instances[i]));
legoc's avatar
legoc committed
461
462
463
		}
	}

legoc's avatar
legoc committed
464
	return unique_ptr<Instance>(nullptr);
legoc's avatar
legoc committed
465
466
}

467
468
469
470
471
472
473
474
475
476
void This::stoppingFunction(StopFunctionType stop) {

	application::State state = waitForStop();

	// Only stop in case of STOPPING.
	if (state == application::STOPPING) {
		stop();
	}
}

legoc's avatar
legoc committed
477
void This::handleStopImpl(StopFunctionType function) {
478
	m_stopHandler = unique_ptr<HandlerImpl>(new HandlerImpl(bind(&This::stoppingFunction, this, function)));
legoc's avatar
legoc committed
479
480
481
482
483
}

///////////////////////////////////////////////////////////////////////////////
// Instance

484
485
486
487
488
489
490
491
492
493
Instance::Com::Com(Server * server) :
	m_server(server),
	m_applicationId(-1) {
}

std::string Instance::Com::getKeyValue(const std::string& key) const {
	// TODO catch exceptions and rethrow an exception: TerminatedException?
	return m_server->getKeyValue(m_applicationId, key);
}

494
Instance::Instance(Server * server) :
legoc's avatar
legoc committed
495
496
	m_server(server),
	m_id(-1),
497
	m_com(server),
legoc's avatar
legoc committed
498
499
500
	m_pastStates(0),
	m_initialState(UNKNOWN),
	m_lastState(UNKNOWN),
501
502
	m_hasResult(false),
	m_exitCode(-1) {
503
504

	m_waiting.reset(new GenericWaitingImpl(bind(&Instance::cancelWaitFor, this)));
legoc's avatar
legoc committed
505
506
507
}

Instance::~Instance() {
508
509
510
511
	// Unregister the instance.
	m_server->unregisterEventListener(this);

	// The destructor has been added to avoid blocking ZeroMQ, because the inner objects destructors were not called.
legoc's avatar
legoc committed
512
513
514
515
}

void Instance::setId(int id) {
	m_id = id;
516
	m_com.m_applicationId = id;
legoc's avatar
legoc committed
517
518
}

legoc's avatar
legoc committed
519
520
521
522
const std::string& Instance::getName() const {
	return EventListener::m_name;
}

legoc's avatar
legoc committed
523
524
525
526
void Instance::setErrorMessage(const std::string& message) {
	m_errorMessage = message;
}

legoc's avatar
legoc committed
527
void Instance::setOutputStreamSocket(std::unique_ptr<OutputStreamSocket>& socket) {
528
529
530
531
	if (socket) {
		m_outputStreamSocket = std::move(socket);
		m_outputStreamSocket->setApplicationId(m_id);
	}
legoc's avatar
legoc committed
532
533
}

legoc's avatar
legoc committed
534
535
536
537
538
539
void Instance::setPastStates(State pastStates) {
	m_pastStates = pastStates;
}

void Instance::setInitialState(State state) {
	m_initialState = state;
540
541
542

	// It is important to set the last state, because in case of a call to the function now without any incoming state.
	m_lastState = state;
legoc's avatar
legoc committed
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
}

int Instance::getId() const {
	return m_id;
}

const std::string& Instance::getUrl() const {
	return m_server->getUrl();
}

const std::string& Instance::getEndpoint() const {
	return m_server->getEndpoint();
}

std::string Instance::getNameId() const {
	stringstream os;
	os << m_name << "." << m_id;

	return os.str();
}

564
565
566
567
const Instance::Com& Instance::getCom() const {
	return m_com;
}

legoc's avatar
legoc committed
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
bool Instance::hasResult() const {
	return m_hasResult;
}

bool Instance::exists() const {
	return (m_id != -1);
}

const std::string& Instance::getErrorMessage() const {
	return m_errorMessage;
}

bool Instance::stop() {
	try {
		Response response = m_server->stopApplicationAsynchronously(m_id, false);

	} catch (const ConnectionTimeout& e) {
		m_errorMessage = e.what();
		return false;
	}

	return true;
}

bool Instance::kill() {
	try {
		Response response = m_server->stopApplicationAsynchronously(m_id, true);

	} catch (const ConnectionTimeout& e) {
		m_errorMessage = e.what();
		return false;
	}

	return true;
}

604
State Instance::waitFor(int states, const std::string& eventName, KeyValue& keyValue, StateHandlerType handler, bool blocking) {
legoc's avatar
legoc committed
605
606

	if (!exists()) {
607
		// The application was not launched
legoc's avatar
legoc committed
608
609
610
		return m_lastState;
	}

611
	// Test the terminal state
legoc's avatar
legoc committed
612
613
614
	if (m_lastState == SUCCESS
		|| m_lastState == STOPPED
		|| m_lastState == KILLED
legoc's avatar
legoc committed
615
		|| m_lastState == FAILURE) {
616
		// The application is already terminated
legoc's avatar
legoc committed
617
618
619
		return m_lastState;
	}

620
	// Test the requested states
legoc's avatar
legoc committed
621
	if ((states & m_pastStates) != 0) {
622
		// The state is already received
legoc's avatar
legoc committed
623
624
625
626
		return m_lastState;
	}

	while (true) {
627
		// Waits for a new incoming status
628
		unique_ptr<Event> event = popEvent(blocking);
legoc's avatar
legoc committed
629

630
		// The non-blocking call returns a null message.
legoc's avatar
legoc committed
631
		if (event.get() == nullptr) {
legoc's avatar
legoc committed
632
633
634
635
636
637
			return m_lastState;
		}

		if (event->getId() == m_id) {
			StatusEvent * status = dynamic_cast<StatusEvent *>(event.get());

legoc's avatar
legoc committed
638
			if (status != nullptr) {
legoc's avatar
legoc committed
639
640
641
642
				State state = status->getState();
				m_pastStates = status->getPastStates();
				m_lastState = state;

643
644
645
646
647
				// Assign the exit code.
				if (status->getExitCode() != -1) {
					m_exitCode = status->getExitCode();
				}

648
				// Call the state handler.
legoc's avatar
legoc committed
649
				if (handler != nullptr) {
legoc's avatar
legoc committed
650
651
652
					handler(state);
				}

legoc's avatar
legoc committed
653
654
655
656
				// test the terminal state
				if (state == SUCCESS
					|| state == STOPPED
					|| state == KILLED
legoc's avatar
legoc committed
657
					|| state == FAILURE) {
legoc's avatar
legoc committed
658
659
660
661
662
663
664
					break;
				}

				// test the requested states
				if ((states & m_pastStates) != 0) {
					return m_lastState;
				}
665
666
			}
			else {
legoc's avatar
legoc committed
667
668
669
670

				if (ResultEvent * result = dynamic_cast<ResultEvent *>(event.get())) {
					m_hasResult = true;
					m_resultData = result->getData();
671
672
				}
				else if (PublisherEvent * publisher = dynamic_cast<PublisherEvent *>(event.get())) {
legoc's avatar
legoc committed
673
674
675
					if (publisher->getPublisherName() == eventName) {
						break;
					}
676
677
				}
				else if (PortEvent * port = dynamic_cast<PortEvent *>(event.get())) {
legoc's avatar
legoc committed
678
679
680
681
					if (port->getPortName() == eventName) {
						break;
					}
				}
682
683
684
685
686
687
688
689
690
691
692
693
694
				else if (KeyEvent * keyEvent = dynamic_cast<KeyEvent *>(event.get())) {
					if (keyEvent->getKey() == keyValue.getKey()) {
						// Set the status and value.
						if (keyEvent->getStatus() == KeyEvent::Status::STORED) {
							keyValue.setStatus(KeyValue::Status::STORED);
						}
						else {
							keyValue.setStatus(KeyValue::Status::REMOVED);
						}
						keyValue.setValue(keyEvent->getValue());
						break;
					}
				}
695
696
697
				else if (CancelEvent * cancel = dynamic_cast<CancelEvent *>(event.get())) {
					break;
				}
legoc's avatar
legoc committed
698
699
700
701
702
703
704
			}
		}
	}

	return m_lastState;
}

legoc's avatar
legoc committed
705
State Instance::waitFor(int states, StateHandlerType handler) {
706
707
	KeyValue keyValue("");
	return waitFor(states, "", keyValue, handler, true);
legoc's avatar
legoc committed
708
709
710
}

State Instance::waitFor(StateHandlerType handler) {
711
712
	KeyValue keyValue("");
	return waitFor(0, "", keyValue, handler, true);
713
714
715
}

State Instance::waitFor(const std::string& eventName) {
716
717
718
719
720
721
	KeyValue keyValue("");
	return waitFor(0, eventName, keyValue, nullptr, true);
}

State Instance::waitFor(KeyValue& keyValue) {
	return waitFor(0, "", keyValue, nullptr, true);
legoc's avatar
legoc committed
722
723
724
}

void Instance::cancelWaitFor() {
725
	cancel(m_id);
legoc's avatar
legoc committed
726
727
}

728
State Instance::now() {
729
730
731
732
733
734

	// First implementation used getLastState().
	return getActualState();
}

State Instance::getLastState() {
735
736
	KeyValue keyValue("");
	return waitFor(0, "", keyValue, nullptr, false);
737
738
}

739
State Instance::getActualState() const {
740
741
	return m_server->getActualState(m_id);
}
742

743
744
std::set<State> Instance::getPastStates() const {
	return m_server->getPastStates(m_id);
745
746
}

747
748
749
750
int Instance::getExitCode() const {
	return m_exitCode;
}

legoc's avatar
legoc committed
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
bool Instance::getBinaryResult(std::string& result) {

	waitFor();
	result = m_resultData;

	return m_hasResult;
}

bool Instance::getResult(std::string& result) {

	string bytes;
	getBinaryResult(bytes);
	parse(bytes, result);

	return m_hasResult;
}

legoc's avatar
legoc committed
768
769
770
771
std::shared_ptr<OutputStreamSocket> Instance::getOutputStreamSocket() {
	return m_outputStreamSocket;
}

legoc's avatar
legoc committed
772
773
774
775
776
777
778
779
780
781
///////////////////////////////////////////////////////////////////////////
// InstanceArray

InstanceArray::InstanceArray() :
	m_size(0),
	m_array(0) {
}

InstanceArray::InstanceArray(const InstanceArray& array) :
	m_size(array.m_size),
legoc's avatar
legoc committed
782
	m_array(new unique_ptr<Instance>[m_size]) {
legoc's avatar
legoc committed
783
784
785

	// transferring pointers
	for (size_t i = 0; i < m_size; i++) {
legoc's avatar
legoc committed
786
		m_array[i] = std::move(array.m_array[i]);
legoc's avatar
legoc committed
787
788
789
790
791
792
793
794
795
	}
}

InstanceArray::~InstanceArray() {
	delete [] m_array;
}

void InstanceArray::allocate(std::size_t size) {
	m_size = size;
legoc's avatar
legoc committed
796
	m_array = new unique_ptr<Instance>[size];
legoc's avatar
legoc committed
797
798
799
800
801
802
}

std::size_t InstanceArray::size() const {
	return m_size;
}

legoc's avatar
legoc committed
803
std::unique_ptr<Instance>& InstanceArray::operator[](std::size_t index) {
legoc's avatar
legoc committed
804
805
806
807
808
809
	return m_array[index];
}

///////////////////////////////////////////////////////////////////////////////
// Publisher

legoc's avatar
legoc committed
810
Publisher::Publisher(This * application, int publisherPort, int synchronizerPort, const std::string& name, int numberOfSubscribers) :
legoc's avatar
legoc committed
811
812
813
814
815
816
817
818
819
	m_impl(new PublisherImpl(application, publisherPort, synchronizerPort, name, numberOfSubscribers)) {

	// Create the waiting here.
	m_waiting.reset(m_impl->waiting());
}

Publisher::~Publisher() {
}

legoc's avatar
legoc committed
820
std::unique_ptr<Publisher> Publisher::create(const std::string& name, int numberOfSubscribers) {
legoc's avatar
legoc committed
821

822
	unique_ptr<zmq::message_t> reply = This::m_instance.m_requestSocket->request(This::m_instance.m_impl->createCreatePublisherRequest(This::m_instance.m_id, name, numberOfSubscribers));
legoc's avatar
legoc committed
823

824
825
826
	// Get the JSON response.
	json::Object response;
	json::parse(response, reply.get());
legoc's avatar
legoc committed
827

828
	int publisherPort = response[message::PublisherResponse::PUBLISHER_PORT].GetInt();
legoc's avatar
legoc committed
829
	if (publisherPort == -1) {
830
		throw PublisherCreationException(response[message::PublisherResponse::MESSAGE].GetString());
legoc's avatar
legoc committed
831
	}
832
	int synchronizerPort = response[message::PublisherResponse::SYNCHRONIZER_PORT].GetInt();;
legoc's avatar
legoc committed
833

legoc's avatar
legoc committed
834
	return unique_ptr<Publisher>(new Publisher(&This::m_instance, publisherPort, synchronizerPort, name, numberOfSubscribers));
legoc's avatar
legoc committed
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
}


const std::string& Publisher::getName() const {
	return m_impl->getName();
}

const std::string& Publisher::getApplicationName() const {
	return m_impl->getApplicationName();
}

int Publisher::getApplicationId() const {
	return m_impl->getApplicationId();
}

const std::string& Publisher::getApplicationEndpoint() const {
	return m_impl->getApplicationEndpoint();
}

bool Publisher::waitForSubscribers() const {
	return m_impl->waitForSubscribers();
}

void Publisher::cancelWaitForSubscribers() {
	m_waiting->cancel();
}

void Publisher::sendBinary(const std::string& data) const {
	m_impl->sendBinary(data);
}

void Publisher::send(const std::string& data) const {
	m_impl->send(data);
}

870
871
872
873
void Publisher::sendTwoBinaryParts(const std::string& data1, const std::string& data2) const {
	m_impl->sendTwoBinaryParts(data1, data2);
}

legoc's avatar
legoc committed
874
bool Publisher::hasEnded() const {
875
876
877
878
879
	return m_impl->isEnded();
}

bool Publisher::isEnded() const {
	return m_impl->isEnded();
legoc's avatar
legoc committed
880
881
882
883
884
885
886
887
888
}

void Publisher::sendEnd() const {
	m_impl->setEnd();
}

///////////////////////////////////////////////////////////////////////////
// Subscriber

889
Subscriber::Subscriber(Server * server, const std::string & url, int publisherPort, int synchronizerPort, const std::string & publisherName, int numberOfSubscribers, const std::string& instanceName, int instanceId, const std::string& instanceEndpoint, const std::string& statusEndpoint) :
legoc's avatar
legoc committed
890
891
892
893
894
895
	m_impl(new SubscriberImpl(server, url, publisherPort, synchronizerPort, publisherName, numberOfSubscribers, instanceName, instanceId, instanceEndpoint, statusEndpoint)) {
}

Subscriber::~Subscriber() {
}

legoc's avatar
legoc committed
896
std::unique_ptr<Subscriber> Subscriber::create(Instance & instance, const std::string& publisherName) {
legoc's avatar
legoc committed
897
898
899
900
901
902
903
904
	try {
		return instance.m_server->createSubscriber(instance.m_id, publisherName, instance.m_name);

	} catch (const SubscriberCreationException& e) {
		// the publisher does not exist, so we are waiting for it
	}

	// waiting for the publisher
905
	State lastState = instance.waitFor(publisherName);
legoc's avatar
legoc committed
906
907
908
909
910

	// state cannot be terminal or it means that the application has terminated that is not planned.
	if (lastState == SUCCESS
		|| lastState == STOPPED
		|| lastState == KILLED
legoc's avatar
legoc committed
911
		|| lastState == FAILURE) {
legoc's avatar
legoc committed
912
		return unique_ptr<Subscriber>(nullptr);
legoc's avatar
legoc committed
913
914
915
916
917
918
919
920
921
	}

	try {
		return instance.m_server->createSubscriber(instance.m_id, publisherName, instance.m_name);

	} catch (const SubscriberCreationException& e) {
		// that should not happen
	}

legoc's avatar
legoc committed
922
	return unique_ptr<Subscriber>(nullptr);
legoc's avatar
legoc committed
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
}

void Subscriber::init() {
	m_impl->init();

	// Create the waiting here.
	m_waiting.reset(m_impl->waiting());
}

const std::string& Subscriber::getPublisherName() const {
	return m_impl->m_publisherName;
}

const std::string& Subscriber::getInstanceName() const {
	return m_impl->m_instanceName;
}

int Subscriber::getInstanceId() const {
	return m_impl->m_instanceId;
}

const std::string& Subscriber::getInstanceEndpoint() const {
	return m_impl->m_instanceEndpoint;
}

bool Subscriber::hasEnded() const {
949
950
951
952
953
954
955
956
957
	return m_impl->isEnded();
}

bool Subscriber::isEnded() const {
	return m_impl->isEnded();
}

bool Subscriber::isCanceled() const {
	return m_impl->isCanceled();
legoc's avatar
legoc committed
958
959
960
961
962
963
964
965
966
967
}

bool Subscriber::receiveBinary(std::string& data) const {
	return m_impl->receiveBinary(data);
}

bool Subscriber::receive(std::string& data) const {
	return m_impl->receive(data);
}

968
969
970
971
bool Subscriber::receiveTwoBinaryParts(std::string& data1, std::string& data2) const {
	return m_impl->receiveTwoBinaryParts(data1, data2);
}

legoc's avatar
legoc committed
972
973
974
975
976
977
978
void Subscriber::cancel() {
	m_waiting->cancel();
}

///////////////////////////////////////////////////////////////////////////
// Request

legoc's avatar
legoc committed
979
980
Request::Request(std::unique_ptr<RequestImpl> & impl) :
	m_impl(std::move(impl)) {
legoc's avatar
legoc committed
981
982
983
984
985
}

Request::~Request() {
}

legoc's avatar
legoc committed
986
987
988
989
990
991
992
993
994
995
996
std::string Request::getObjectId() const {

	// Local id is missing.
	return "request:"
		+ m_impl->m_requesterApplicationName
		+ "."
		+ to_string(m_impl->m_requesterApplicationId)
		+ "@"
		+ m_impl->m_requesterServerEndpoint;
}

997
998
999
1000
std::string Request::getRequesterEndpoint() const {
	return m_impl->m_requesterServerEndpoint;
}

legoc's avatar
legoc committed
1001
1002
void Request::setTimeout(int value) {
	m_impl->setTimeout(value);
1003
1004
}

1005
const std::string& Request::getBinary() const {
legoc's avatar
legoc committed
1006
1007
1008
	return m_impl->m_message;
}

1009
std::string Request::get() const {
legoc's avatar
legoc committed
1010
1011
1012
1013
1014
1015
1016

	string data;
	parse(m_impl->m_message, data);

	return data;
}

1017
1018
1019
1020
const std::string& Request::getSecondBinaryPart() const {
	return m_impl->m_message2;
}

legoc's avatar
legoc committed
1021
1022
bool Request::replyBinary(const std::string& response) {
	return m_impl->replyBinary(response);
legoc's avatar
legoc committed
1023
1024
}

legoc's avatar
legoc committed
1025
1026
bool Request::reply(const std::string& response) {
	return m_impl->reply(response);
legoc's avatar
legoc committed
1027
1028
}

legoc's avatar
legoc committed
1029
std::unique_ptr<Instance> Request::connectToRequester() {
1030

legoc's avatar
legoc committed
1031
	// Instantiate the requester server if it does not exist.
legoc's avatar
legoc committed
1032
	if (m_requesterServer.get() == nullptr) {
1033
		m_requesterServer.reset(new Server(m_impl->m_requesterServerEndpoint, m_impl->m_timeout));
legoc's avatar
legoc committed
1034
	}
1035
1036
1037
1038
1039
1040

	// Connect and find the instance.
	InstanceArray instances = m_requesterServer->connectAll(m_impl->m_requesterApplicationName);

	for (int i = 0; i < instances.size(); i++) {
		if (instances[i]->getId() == m_impl->m_requesterApplicationId) {
legoc's avatar
legoc committed
1041
			return unique_ptr<Instance>(std::move(instances[i]));
1042
1043
1044
1045
		}
	}

	// Not found.
legoc's avatar
legoc committed
1046
	return unique_ptr<Instance>(nullptr);
1047
1048
}

legoc's avatar
legoc committed
1049
1050
std::unique_ptr<Server> Request::getServer() {
	return std::move(m_requesterServer);
legoc's avatar
legoc committed
1051
1052
}

legoc's avatar
legoc committed
1053
1054
1055
///////////////////////////////////////////////////////////////////////////
// Responder

legoc's avatar
legoc committed
1056
Responder::Responder(application::This * application, int responderPort, const std::string& name) :
legoc's avatar
legoc committed
1057
1058
1059
1060
1061
1062
1063
1064
1065
	m_impl(new ResponderImpl(application, responderPort, name)) {

	// Create the waiting here.
	m_waiting.reset(m_impl->waiting());
}

Responder::~Responder() {
}

legoc's avatar
legoc committed
1066
std::unique_ptr<Responder> Responder::create(const std::string& name) {
legoc's avatar
legoc committed
1067
1068
1069

	string portName = ResponderImpl::RESPONDER_PREFIX + name;

1070
	unique_ptr<zmq::message_t> reply = This::m_instance.m_requestSocket->request(This::m_instance.m_impl->createRequestPortV0Request(This::m_instance.m_id, portName));
legoc's avatar
legoc committed
1071

1072
1073
1074
	// Get the JSON response.
	json::Object response;
	json::parse(response, reply.get());
legoc's avatar
legoc committed
1075

1076
	int responderPort = response[message::RequestResponse::VALUE].GetInt();
legoc's avatar
legoc committed
1077
	if (responderPort == -1) {
1078
		throw ResponderCreationException(response[message::RequestResponse::MESSAGE].GetString());
legoc's avatar
legoc committed
1079
1080
	}

legoc's avatar
legoc committed
1081
	return unique_ptr<Responder>(new Responder(&This::m_instance, responderPort, name));
legoc's avatar
legoc committed
1082
1083
1084
1085
1086
1087
1088
1089
1090
1091
}

const std::string& Responder::getName() const {
	return m_impl->m_name;
}

void Responder::cancel() {
	m_impl->cancel();
}

legoc's avatar
legoc committed
1092
std::unique_ptr<Request> Responder::receive() {
legoc's avatar
legoc committed
1093

legoc's avatar
legoc committed
1094
1095
1096
	unique_ptr<RequestImpl> requestImpl = m_impl->receive();
	if (requestImpl.get() == nullptr) {
		return unique_ptr<Request>(nullptr);
legoc's avatar
legoc committed
1097
	}
legoc's avatar
legoc committed
1098
	return unique_ptr<Request>(new Request(requestImpl));
legoc's avatar
legoc committed
1099
1100
}

1101
1102
bool Responder::isCanceled() const {
	return m_impl->m_canceled;
legoc's avatar
legoc committed
1103
1104
1105
1106
1107
}

///////////////////////////////////////////////////////////////////////////
// Requester

legoc's avatar
legoc committed
1108
Requester::Requester(application::This * application, const std::string& url, int requesterPort, int responderPort, const std::string& name, int responderId, int requesterId) :
1109
	m_impl(new RequesterImpl(application, url, requesterPort, responderPort, name, responderId, requesterId)) {
legoc's avatar
legoc committed
1110
1111
1112
1113
1114
1115
1116
1117

	// Create the waiting here.
	m_waiting.reset(m_impl->waiting());
}

Requester::~Requester() {
}

legoc's avatar
legoc committed
1118
std::unique_ptr<Requester> Requester::create(Instance & instance, const std::string& name) {
legoc's avatar
legoc committed
1119
1120
1121
1122
1123

	int responderId = instance.getId();
	string responderUrl = instance.getUrl();
	string responderEndpoint = instance.getEndpoint();

legoc's avatar
legoc committed
1124
1125
1126
	// Create a request socket to the server of the instance.
	unique_ptr<RequestSocketImpl> instanceRequestSocket = This::m_instance.createRequestSocket(responderEndpoint);

legoc's avatar
legoc committed
1127
	string responderPortName = ResponderImpl::RESPONDER_PREFIX + name;
1128
1129
	int requesterId = RequesterImpl::newRequesterId();
	string requesterPortName = RequesterImpl::getRequesterPortName(name, responderId, requesterId);
legoc's avatar
legoc committed
1130

1131
	string request = This::m_instance.m_impl->createConnectPortV0Request(responderId, responderPortName);
1132
1133

	unique_ptr<zmq::message_t> reply = instanceRequestSocket->request(request);
legoc's avatar
legoc committed
1134

1135
1136
1137
	// Get the JSON response.
	json::Object response;
	json::parse(response, reply.get());
legoc's avatar
legoc committed
1138

1139
	reply.reset();
legoc's avatar
legoc committed
1140

1141
	int responderPort = response[message::RequestResponse::VALUE].GetInt();
legoc's avatar
legoc committed
1142
1143
	if (responderPort == -1) {
		// Wait for the responder port.
1144
		instance.waitFor(responderPortName);
legoc's avatar
legoc committed
1145
1146

		// Retry to connect.
1147
1148
		reply = instanceRequestSocket->request(request);
		json::parse(response, reply.get());
legoc's avatar
legoc committed
1149

1150
		responderPort = response[message::RequestResponse::VALUE].GetInt();
legoc's avatar
legoc committed
1151
		if (responderPort == -1) {
1152
			throw RequesterCreationException(response[message::RequestResponse::MESSAGE].GetString());
legoc's avatar
legoc committed
1153
		}
1154
1155

		reply.reset();
legoc's avatar
legoc committed
1156
1157
	}

1158
	// Request a requester port.
1159
	reply = This::m_instance.m_requestSocket->request(This::m_instance.m_impl->createRequestPortV0Request(This::m_instance.m_id, requesterPortName));
1160
	json::parse(response, reply.get());
legoc's avatar
legoc committed
1161

1162
	int requesterPort = response[message::RequestResponse::VALUE].GetInt();
legoc's avatar
legoc committed
1163
	if (requesterPort == -1) {
1164
		throw RequesterCreationException(response[message::RequestResponse::MESSAGE].GetString());
legoc's avatar
legoc committed
1165
1166
	}

legoc's avatar
legoc committed
1167
	return unique_ptr<Requester>(new Requester(&This::m_instance, responderUrl, requesterPort, responderPort, name, responderId, requesterId));
legoc's avatar
legoc committed
1168
1169
1170
1171
1172
1173
1174
1175
1176
1177
1178
1179
1180
1181
}

const std::string& Requester::getName() const {
	return m_impl->m_name;
}

void Requester::sendBinary(const std::string& request) {
	m_impl->sendBinary(request);
}

void Requester::send(const std::string& request) {
	m_impl->send(request);
}

1182
1183
1184
1185
void Requester::sendTwoBinaryParts(const std::string& request1, const std::string& request2) {
	m_impl->sendTwoBinaryParts(request1, request2);
}

legoc's avatar
legoc committed
1186
1187
1188
1189
1190
1191
1192
1193
1194
1195
1196
1197
bool Requester::receiveBinary(std::string& response) {
	return m_impl->receiveBinary(response);
}

bool Requester::receive(std::string& response) {
	return m_impl->receive(response);
}

void Requester::cancel() {
	m_impl->cancel();
}

1198
1199
1200
1201
bool Requester::isCanceled() const {
	return m_impl->m_canceled;
}

legoc's avatar
legoc committed
1202
1203
1204
///////////////////////////////////////////////////////////////////////////
// Configuration

1205
Configuration::Configuration(const std::string& name, const std::string& description, bool singleInstance, bool restart, int startingTime, int stoppingTime) {
legoc's avatar
legoc committed
1206
1207
1208
1209
1210
1211
1212
1213
1214
1215
1216
1217
1218
1219
1220
1221
1222
1223
1224
1225
1226
1227
1228
1229
1230
1231
1232
1233
1234
1235
1236
1237
1238
1239
1240
1241

	m_name = name;
	m_description = description;
	m_singleInstance = singleInstance;
	m_restart = restart;
	m_startingTime = startingTime;
	m_stoppingTime = stoppingTime;
}

const std::string& Configuration::getName() const {
	return m_name;
}

const std::string& Configuration::getDescription() const {
	return m_description;
}

bool Configuration::hasSingleInstance() const {
	return m_singleInstance;
}

bool Configuration::canRestart() const {
	return m_restart;
}

int Configuration::getStartingTime() const {
	return m_startingTime;
}

int Configuration::getStoppingTime() const {
	return m_stoppingTime;
}

///////////////////////////////////////////////////////////////////////////
// Info

legoc's avatar
legoc committed
1242
Info::Info(const std::string& name, int id, int pid, State applicationState, State pastApplicationStates, const std::string& args) :
legoc's avatar
legoc committed
1243
	m_id(id),
legoc's avatar
legoc committed
1244
	m_pid(pid),
legoc's avatar
legoc committed
1245
1246
1247
1248
1249
1250
1251
1252
1253
1254
1255
1256
1257
1258
1259
1260
1261
1262
1263
1264
1265
1266
1267
1268
1269
1270
	m_applicationState(applicationState),
	m_pastApplicationStates(pastApplicationStates),
	m_args(args),
	m_name(name) {
}

int Info::getId() const {
	return m_id;
}

State Info::getState() const {
	return m_applicationState;
}

State Info::getPastStates() const {
	return m_pastApplicationStates;
}

const std::string& Info::getArgs() const {
	return m_args;
}

const std::string& Info::getName() const {
	return m_name;
}

legoc's avatar
legoc committed
1271
1272
1273
int Info::getPid() const {
	return m_pid;
}
legoc's avatar
legoc committed
1274

1275
1276
1277
///////////////////////////////////////////////////////////////////////////
// Port

legoc's avatar
legoc committed
1278
Port::Port(int port, const std::string& status, const std::string& owner) :
1279
1280
	m_port(port),
	m_status(status),
legoc's avatar
legoc committed
1281
	m_owner(owner) {
1282
1283
1284
1285
1286
1287
1288
1289
1290
1291
}

int Port::getPort() const {
	return m_port;
}

const std::string& Port::getStatus() const {
	return m_status;
}

legoc's avatar
legoc committed
1292
1293
const std::string& Port::getOwner() const {
	return m_owner;
1294
1295
}

legoc's avatar
legoc committed
1296
1297
1298
1299
1300
1301
1302
1303
1304
1305
1306
1307
1308
1309
1310
1311
1312
1313
1314
1315
1316
1317
1318
1319
std::string toString(cameo::application::State applicationStates) {

	vector<string> states;

	if ((applicationStates & STARTING) != 0) {
		states.push_back("STARTING");
	}

	if ((applicationStates & RUNNING) != 0) {
		states.push_back("RUNNING");
	}

	if ((applicationStates & STOPPING) != 0) {
		states.push_back("STOPPING");
	}

	if ((applicationStates & KILLING) != 0) {
		states.push_back("KILLING");
	}

	if ((applicationStates & PROCESSING_ERROR) != 0) {
		states.push_back("PROCESSING_ERROR");
	}

legoc's avatar
legoc committed
1320
	if ((applicationStates & FAILURE) != 0) {
legoc's avatar
legoc committed
1321
1322
1323
1324
1325
1326
1327
1328
1329
1330
1331
1332
1333
1334
1335
1336
1337
1338
1339
1340
1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
		states.push_back("ERROR");
	}

	if ((applicationStates & SUCCESS) != 0) {
		states.push_back("SUCCESS");
	}

	if ((applicationStates & STOPPED) != 0) {
		states.push_back("STOPPED");
	}

	if ((applicationStates & KILLED) != 0) {
		states.push_back("KILLED");
	}

	if (states.size() == 0) {
		return "UNKNOWN";
	}

	if (states.size() == 1) {
		return states.front();
	}

	ostringstream result;

	for (int i = 0; i < states.size() - 1; i++) {
		result << states[i] << ", ";
	}
	result << states.back();

	return result.str();
}

///////////////////////////////////////////////////////////////////////////////
// operator<<

std::ostream& operator<<(std::ostream& os, const cameo::application::This& application) {

	os << application.m_name << "." << application.m_id << "@" << application.m_serverEndpoint;

	return os;
}

std::ostream& operator<<(std::ostream& os, const application::Instance& instance) {

	os << instance.m_name << "." << instance.m_id << "@" << instance.m_server->getEndpoint();

	return os;
}

std::ostream& operator<<(std::ostream& os, const application::Publisher& publisher) {

	os << "pub." << publisher.getName()
		<< ":" << publisher.getApplicationName()
		<< "." << publisher.getApplicationId()
		<< "@" << publisher.getApplicationEndpoint();

	return os;
}

std::ostream& operator<<(std::ostream& os, const application::Subscriber& subscriber) {

	os << "sub." << subscriber.getPublisherName()
		<< ":" << subscriber.getInstanceName()
		<< "." << subscriber.getInstanceId()
		<< "@" << subscriber.getInstanceEndpoint();

	return os;
}

std::ostream& operator<<(std::ostream& os, const application::Request& request) {

	os << "[endpoint=" << request.m_impl->m_requesterEndpoint
			<< ", id=" << request.m_impl->m_requesterApplicationId << "]";

	return os;
}

std::ostream& operator<<(std::ostream& os, const application::Responder