Go to the documentation of this file.00001
00002
00003
00004
00005
00006
00007
00008
00009
00010
00011
00012
00013
00014
00015
00016
00017
00018
00019
00020
00021
00022
00023
00024
00025
00026
00027
00028
00029
00030
00031
00032
00033
00034
00035
00036
00037
00038
00039
00040
00041 #include "jaus/core/service.h"
00042 #include "jaus/core/transport/transport.h"
00043 #include "jaus/core/component.h"
00044 #include "jaus/core/sensor.h"
00045 #include <cstdio>
00046
00047 using namespace JAUS;
00048
00049 Mutex Service::mDebugMessagesMutex("JAUS");
00050
00059 Service::ID::ID(const std::string& name, const double version) : mName(name),
00060 mVersion(version)
00061 {
00062 }
00063
00064
00070 Service::ID::ID(const ID& id)
00071 {
00072 *this = id;
00073 }
00074
00075
00081 Service::ID::~ID()
00082 {
00083 }
00084
00085
00096 int Service::ID::Write(Packet& packet) const
00097 {
00098 Byte majorVersionNumber = (Byte)mVersion;
00099 Byte minorVersionNumber = (Byte)((mVersion - majorVersionNumber)*10);
00100 int result = 0;
00101 result += packet.Write( (Byte)(mName.size()) );
00102 result += packet.Write(mName);
00103 result += packet.Write(majorVersionNumber);
00104 result += packet.Write(minorVersionNumber);
00105
00106 return result;
00107 }
00108
00109
00120 int Service::ID::Read(const Packet& packet)
00121 {
00122 Byte strLen = 0;
00123 Byte majorVersionNumber = 0, minorVersionNumber = 0;
00124 int result = 0;
00125
00126 result += packet.Read(strLen);
00127 if(result > 0 && strLen > 0)
00128 {
00129 result += packet.Read(mName, (unsigned int)strLen);
00130 result += packet.Read(majorVersionNumber);
00131 result += packet.Read(minorVersionNumber);
00132 mVersion = majorVersionNumber + minorVersionNumber/10.0;
00133 }
00134 return result;
00135 }
00136
00137
00143 void Service::ID::Clear()
00144 {
00145 mName.clear();
00146 mVersion = 0.0;
00147 }
00148
00149
00155 std::string Service::ID::ToString(const bool nameOnly, const bool trim) const
00156 {
00157 char buffer[512];
00158 size_t found;
00159 found = mName.find_last_of(":");
00160 std::string n = mName.substr(found + 1);
00161 if(trim && n.size() > 0)
00162 {
00163 if(nameOnly)
00164 {
00165 return n;
00166 }
00167 else
00168 {
00169 sprintf(buffer, "%s - version=%.2lf", n.c_str(), mVersion);
00170 }
00171 }
00172 else
00173 {
00174 if(nameOnly)
00175 {
00176 return mName;
00177 }
00178 else
00179 {
00180 sprintf(buffer, "%s - version=%.2lf", mName.c_str(), mVersion);
00181 }
00182 }
00183 return std::string(buffer);
00184 }
00185
00186
00192 Service::ID& Service::ID::operator =(const Service::ID& id)
00193 {
00194 if(this != &id)
00195 {
00196 mName = id.mName;
00197 mVersion = id.mVersion;
00198 }
00199 return *this;
00200 }
00201
00202
00213 Service::Service(const ID& serviceIdentifier, const ID& parentServiceIdentifier) : mServiceID(serviceIdentifier),
00214 mParentServiceID(parentServiceIdentifier)
00215 {
00216 mServiceEnabledFlag = true;
00217 mpJausParentService = NULL;
00218 mDebugMessagesFlag = false;
00219 mpTransportService = dynamic_cast<Transport *>(this);
00220 mpComponent = NULL;
00221 mShutdownServiceFlag = false;
00222 }
00223
00224
00230 Service::~Service()
00231 {
00232 Mutex::ScopedLock lock(&mJausServiceMutex);
00233 mServiceID.Clear();
00234 mParentServiceID.Clear();
00235 mJausChildServices.clear();
00236 mpJausParentService = NULL;
00237 mShutdownServiceFlag = true;
00238 }
00239
00240
00254 bool Service::Send(const Message* message, const int broadcastFlags) const
00255 {
00256 if(mpTransportService)
00257 {
00258 return mpTransportService->Send(message, broadcastFlags);
00259 }
00260 return false;
00261 }
00262
00263
00277 bool Service::Send(const Message* message,
00278 Message* response,
00279 const unsigned int waitTimeMs) const
00280 {
00281 if(mpTransportService)
00282 {
00283 return mpTransportService->Send(message, response, waitTimeMs);
00284 }
00285 return false;
00286 }
00287
00288
00306 bool Service::Send(const Message* message,
00307 Message::List& possibleResponses,
00308 const unsigned int waitTimeMs) const
00309 {
00310 if(mpTransportService)
00311 {
00312 return mpTransportService->Send(message, possibleResponses, waitTimeMs);
00313 }
00314 return false;
00315 }
00316
00317
00332 void Service::Receive(const Message* message)
00333 {
00334 }
00335
00336
00346 bool Service::SetComponentID(const Address& id)
00347 {
00348 if(id.IsValid() && !id.IsBroadcast())
00349 {
00350 mComponentID = id;
00351 Service::Map::iterator child;
00352 Service::Map *children = &mJausChildServices;
00353 for(child = children->begin();
00354 child != children->end();
00355 child++)
00356 {
00357 child->second->SetComponentID(id);
00358 }
00359 return true;
00360 }
00361 return false;
00362 }
00363
00364
00375 bool Service::InheritsFrom(const Service::ID& id) const
00376 {
00377 Mutex::ScopedLock lock(&mJausServiceMutex);
00378 if(mParentServiceID.mName == id.mName)
00379 {
00380 return true;
00381 }
00382 return false;
00383 }
00384
00385
00395 bool Service::AddChildService(Service* childService)
00396 {
00397 bool result = false;
00398
00399 if(childService->InheritsFrom(mServiceID) == false)
00400 return result;
00401
00402 Mutex::ScopedLock lock(&mJausServiceMutex);
00403 if(mpTransportService == NULL)
00404 {
00405 mpTransportService = dynamic_cast<Transport *>(this);
00406 Service* parent = mpJausParentService;
00407 while(mpTransportService == NULL || parent != NULL)
00408 {
00409 Transport* transport = dynamic_cast<Transport *>(parent);
00410 if(transport)
00411 {
00412 mpTransportService = transport;
00413 break;
00414 }
00415 parent = parent->mpJausParentService;
00416 }
00417 }
00418 Map::iterator child = mJausChildServices.find(childService->mServiceID.mName);
00419 if(child == mJausChildServices.end())
00420 {
00421 mJausChildServices[childService->mServiceID.mName] = childService;
00422 if(mpTransportService)
00423 {
00424 childService->mpTransportService = mpTransportService;
00425 }
00426 childService->mpJausParentService = this;
00427 childService->SetComponent(mpComponent);
00428 result = true;
00429 }
00430 return result;
00431 }
00432
00433
00443 bool Service::SetParentService(Service* parentService)
00444 {
00445
00446 Mutex::ScopedLock lock(&mJausServiceMutex);
00447 if(InheritsFrom(parentService->mServiceID) == false)
00448 {
00449 return false;
00450 }
00451
00452 mpJausParentService = parentService;
00453 return true;
00454 }
00455
00456
00462 Service* Service::GetParentService()
00463 {
00464 return mpJausParentService;
00465 }
00466
00467
00473 const Service* Service::GetParentService() const
00474 {
00475 return mpJausParentService;
00476 }
00477
00478
00486 Service* Service::GetChildService(const Service::ID& id)
00487 {
00488 Mutex::ScopedLock lock(&mJausServiceMutex);
00489 Map::iterator child;
00490 child = mJausChildServices.find(id.mName);
00491 if(child != mJausChildServices.end())
00492 {
00493 return child->second;
00494 }
00495 return NULL;
00496 }
00497
00498
00506 const Service* Service::GetChildService(const Service::ID& id) const
00507 {
00508 Mutex::ScopedLock lock(&mJausServiceMutex);
00509 Map::const_iterator child;
00510 child = mJausChildServices.find(id.mName);
00511 if(child != mJausChildServices.end())
00512 {
00513 return child->second;
00514 }
00515 return NULL;
00516 }
00517
00518
00531 Service::ID::Set Service::GetServices() const
00532 {
00533 Mutex::ScopedLock lock(&mJausServiceMutex);
00534 Service::ID::Set services;
00535 Service::ID::Set::iterator s;
00536
00537 services.insert(this->GetServiceID());
00538
00539 Map::const_iterator child;
00540 for(child = mJausChildServices.begin();
00541 child != mJausChildServices.end();
00542 child++)
00543 {
00544 if(child->second->IsDiscoverable())
00545 {
00546 const Sensor* sensor = dynamic_cast<Sensor *>(child->second);
00547 if(sensor && sensor->IsSynchronizing())
00548 {
00549 continue;
00550 }
00551 Service::ID::Set childServices = child->second->GetServices();
00552 for(s = childServices.begin();
00553 s != childServices.end();
00554 s++)
00555 {
00556 services.insert(*s);
00557 }
00558 }
00559 }
00560 return services;
00561 }
00562
00563
00575 void Service::RecursiveShutdown()
00576 {
00577 Map::iterator child;
00578 child = mJausChildServices.begin();
00579 while(child != mJausChildServices.end())
00580 {
00581 child->second->RecursiveShutdown();
00582 child++;
00583 }
00584 Shutdown();
00585 }
00586
00587
00597 void Service::SetComponent(Component* component)
00598 {
00599 if(component == NULL) { return; }
00600 Mutex::ScopedLock lock(&mJausServiceMutex);
00601 mpComponent = component;
00602 if(component->TransportService())
00603 {
00604 mpTransportService = component->TransportService();
00605 }
00606 Map::iterator child;
00607 for(child = mJausChildServices.begin();
00608 child != mJausChildServices.end();
00609 child++)
00610 {
00611 child->second->SetComponent(component);
00612 }
00613 }
00614
00615
00624 void Service::PushMessageToChildren(const Message* message)
00625 {
00626 Transport* transport = dynamic_cast<Transport *>(this);
00627 if(transport)
00628 {
00629 transport->TriggerMessageCallbacks(message);
00630
00631
00632 if(message->IsCommand() &&
00633 mpComponent->AccessControlService()->AcceptCommandMessage(message) == false)
00634 {
00635 return;
00636 }
00637
00638 Service::Map services = mpComponent->GetServices();
00639 Service::Map::iterator s;
00640 for(s = services.begin();
00641 s != services.end();
00642 s++)
00643 {
00644 if(s->second != transport && s->second->mServiceEnabledFlag)
00645 {
00646 s->second->Receive(message);
00647 }
00648 }
00649 }
00650 }
00651
00652
00660 Service::Map Service::GetChildServices()
00661 {
00662 Mutex::ScopedLock lock(&mJausServiceMutex);
00663 Service::Map children = mJausChildServices;
00664 Service::Map::iterator child;
00665 for(child = children.begin();
00666 child != children.end();
00667 child++)
00668 {
00669 Service::Map children2 = child->second->GetChildServices();
00670 Service::Map::iterator child2;
00671 for(child2 = children2.begin();
00672 child2 != children2.end();
00673 child2++)
00674 {
00675 children[child2->first] = child2->second;
00676 }
00677 }
00678 return children;
00679 }
00680
00681
00689 const Service::Map Service::GetChildServices() const
00690 {
00691 Mutex::ScopedLock lock(&mJausServiceMutex);
00692 Service::Map children = mJausChildServices;
00693 Service::Map::const_iterator child;
00694 for(child = children.begin();
00695 child != children.end();
00696 child++)
00697 {
00698 Service::Map children2 = child->second->GetChildServices();
00699 Service::Map::iterator child2;
00700 for(child2 = children2.begin();
00701 child2 != children2.end();
00702 child2++)
00703 {
00704 children[child2->first] = child2->second;
00705 }
00706 }
00707 return children;
00708 }
00709
00710