Salome HOME
Processing instruction is defined now in getScenarioInfo using document types mappings.
[tools/siman.git] / Workspace / Siman-Common / src / org / splat / service / ScenarioServiceImpl.java
1 /*****************************************************************************
2  * Company         OPEN CASCADE
3  * Application     SIMAN
4  * File            $Id$ 
5  * Creation date   06.10.2012
6  * @author         $Author$
7  * @version        $Revision$
8  *****************************************************************************/
9
10 package org.splat.service;
11
12 import java.io.IOException;
13 import java.util.ArrayList;
14 import java.util.Calendar;
15 import java.util.Iterator;
16 import java.util.List;
17
18 import org.apache.log4j.Logger;
19 import org.splat.dal.bo.kernel.Relation;
20 import org.splat.dal.bo.kernel.User;
21 import org.splat.dal.bo.som.ConvertsRelation;
22 import org.splat.dal.bo.som.File;
23 import org.splat.dal.bo.som.KnowledgeElement;
24 import org.splat.dal.bo.som.KnowledgeElementType;
25 import org.splat.dal.bo.som.Publication;
26 import org.splat.dal.bo.som.Scenario;
27 import org.splat.dal.bo.som.SimulationContext;
28 import org.splat.dal.bo.som.Study;
29 import org.splat.dal.dao.kernel.UserDAO;
30 import org.splat.dal.dao.som.KnowledgeElementDAO;
31 import org.splat.dal.dao.som.KnowledgeElementTypeDAO;
32 import org.splat.dal.dao.som.ScenarioDAO;
33 import org.splat.dal.dao.som.StudyDAO;
34 import org.splat.kernel.InvalidPropertyException;
35 import org.splat.kernel.MissedPropertyException;
36 import org.splat.kernel.MultiplyDefinedException;
37 import org.splat.service.dto.DocumentDTO;
38 import org.splat.service.dto.StepDTO;
39 import org.splat.service.technical.IndexService;
40 import org.splat.service.technical.ProjectSettingsService;
41 import org.splat.som.Step;
42 import org.splat.util.BeanHelper;
43 import org.springframework.transaction.annotation.Transactional;
44
45 /**
46  * Scenario service implementation.
47  * 
48  * @author <a href="mailto:roman.kozlov@opencascade.com">Roman Kozlov (RKV)</a>
49  */
50 public class ScenarioServiceImpl implements ScenarioService {
51
52         /**
53          * Logger for this class.
54          */
55         protected final static Logger LOG = Logger
56                         .getLogger(ScenarioServiceImpl.class);
57
58         /**
59          * Injected index service.
60          */
61         private IndexService _indexService;
62         /**
63          * Injected step service.
64          */
65         private StepService _stepService;
66         /**
67          * Injected study service.
68          */
69         private StudyService _studyService;
70         /**
71          * Injected publication service.
72          */
73         private PublicationService _publicationService;
74         /**
75          * Injected project element service.
76          */
77         private ProjectElementService _projectElementService;
78         /**
79          * Injected knowledge element DAO.
80          */
81         private KnowledgeElementDAO _knowledgeElementDAO;
82         /**
83          * Injected scenario DAO.
84          */
85         private ScenarioDAO _scenarioDAO;
86
87         /**
88          * Injected study DAO.
89          */
90         private StudyDAO _studyDAO;
91
92         /**
93          * Injected knowledge element service.
94          */
95         private KnowledgeElementTypeService _knowledgeElementTypeService;
96
97         /**
98          * Injected user service.
99          */
100         private UserService _userService;
101
102         /**
103          * Injected user DAO.
104          */
105         private UserDAO _userDAO;
106
107         /**
108          * Injected knowledge element type DAO.
109          */
110         private KnowledgeElementTypeDAO _knowledgeElementTypeDAO;
111
112         /**
113          * Injected simulation context service.
114          */
115         private SimulationContextService _simulationContextService;
116
117         /**
118          * Injected project service.
119          */
120         private ProjectSettingsService _projectSettings;
121
122         /**
123          * Get the projectElementService.
124          * 
125          * @return the projectElementService
126          */
127         public ProjectElementService getProjectElementService() {
128                 return _projectElementService;
129         }
130
131         /**
132          * Set the projectElementService.
133          * 
134          * @param projectElementService
135          *            the projectElementService to set
136          */
137         public void setProjectElementService(
138                         final ProjectElementService projectElementService) {
139                 _projectElementService = projectElementService;
140         }
141
142         /**
143          * Get the publicationService.
144          * 
145          * @return the publicationService
146          */
147         public PublicationService getPublicationService() {
148                 return _publicationService;
149         }
150
151         /**
152          * Set the publicationService.
153          * 
154          * @param publicationService
155          *            the publicationService to set
156          */
157         public void setPublicationService(
158                         final PublicationService publicationService) {
159                 _publicationService = publicationService;
160         }
161
162         /**
163          * Get the stepService.
164          * 
165          * @return the stepService
166          */
167         public StepService getStepService() {
168                 return _stepService;
169         }
170
171         /**
172          * Set the stepService.
173          * 
174          * @param stepService
175          *            the stepService to set
176          */
177         public void setStepService(final StepService stepService) {
178                 _stepService = stepService;
179         }
180
181         /**
182          * {@inheritDoc}
183          * 
184          * @see org.splat.service.ScenarioService#getScenarioInfo(long)
185          */
186         @Transactional
187         public List<StepDTO> getScenarioInfo(final long scenarioId) {
188                 List<StepDTO> res = new ArrayList<StepDTO>();
189                 // Get the scenario from the database by id
190                 Scenario scen = getScenarioDAO().get(scenarioId);
191                 if (LOG.isDebugEnabled()) {
192                         LOG.debug("Scenario[" + scenarioId + "]: Number of publications: "
193                                         + scen.getDocums().size());
194                 }
195                 // Get activities of the scenario
196                 Step[] steps = getProjectElementService().getSteps(scen);
197                 StepDTO stepDTO;
198                 DocumentDTO docDTO;
199                 String docType, fileFormat;
200                 String processing;
201                 boolean doImport;
202                 // For each activity create a step DTO and add it to the result list
203                 for (Step step : steps) {
204                         stepDTO = BeanHelper.copyBean(step.getStep(), StepDTO.class);
205                         res.add(stepDTO);
206                         if (LOG.isDebugEnabled()) {
207                                 LOG.debug("Step[" + stepDTO.getNumber()
208                                                 + "]: Number of documents: "
209                                                 + step.getDocuments().size());
210                         }
211                         // For each publication of the activity create a document DTO.
212                         // Each file is considered as a source file.
213                         for (Publication tag : step.getDocuments()) {
214                                 docDTO = stepDTO.addDoc(tag.value().getIndex(), tag.value()
215                                                 .getTitle());
216                                 char aState = tag.getIsnew();
217                                 docType = tag.value().getType().getName();
218                                 // For each file of the document create a file DTO
219                                 // Process source file of the document
220                                 fileFormat = tag.value().getFile().getFormat();
221                                 doImport = getProjectSettings().doImport(docType, fileFormat);
222                                 if (doImport && (!tag.isOutdated())) {
223                                         processing = "file-import";
224                                 } else {
225                                         processing = "file-download";
226                                 }
227                                 docDTO.addFile(tag.value().getFile().getRelativePath(), aState,
228                                                 processing, false);
229                                 // Process all exported files
230                                 for (Relation rel : tag.value().getRelations(
231                                                 ConvertsRelation.class)) {
232                                         File aFile = ((ConvertsRelation) rel).getTo();
233                                         fileFormat = aFile.getFormat();
234                                         doImport = getProjectSettings().doImport(docType,
235                                                         fileFormat);
236                                         if (doImport && (!tag.isOutdated())) {
237                                                 processing = "file-import";
238                                         } else {
239                                                 processing = "file-download";
240                                         }
241                                         docDTO.addFile(aFile.getRelativePath(), aState, processing,
242                                                         false);
243                                 }
244                         }
245                 }
246                 return res;
247         }
248
249         /**
250          * Create a new study with one scenario and "product" simulation context.
251          * 
252          * @param sprop
253          *            the study properties
254          * @param oprop
255          *            the scenario properties
256          * @param cprop
257          *            the "product" simulation context properties
258          * @return the created study
259          * @throws MissedPropertyException
260          *             if a mandatory property is missed
261          * @throws InvalidPropertyException
262          *             if a property is invalid
263          * @throws MultiplyDefinedException
264          *             if some property occurs several times
265          */
266         @Transactional
267         public Study createStudy(final Study.Properties sprop,
268                         final Scenario.Properties oprop,
269                         final SimulationContext.Properties cprop)
270                         throws MissedPropertyException, InvalidPropertyException,
271                         MultiplyDefinedException {
272                 Study study = getStudyService().createStudy(sprop);
273                 addScenario(study, oprop);
274                 if (cprop.getIndex() == 0) { // Input of new project context
275                         cprop.setType(getSimulationContextService().selectType("product"))
276                                         .setValue(cprop.getValue());
277                         getStudyService().addProjectContext(study, cprop);
278                 } else { // Selection of existing project context
279                         SimulationContext context = getSimulationContextService()
280                                         .selectSimulationContext(cprop.getIndex());
281                         getStudyService().addProjectContext(study, context);
282                 }
283                 return study;
284         }
285
286         /**
287          * {@inheritDoc}
288          * 
289          * @see org.splat.service.ScenarioService#addKnowledgeElement(org.splat.dal.bo.som.Scenario,
290          *      org.splat.dal.bo.som.KnowledgeElement.Properties)
291          */
292         @Transactional
293         public KnowledgeElement addKnowledgeElement(final Scenario aScenarioDTO,
294                         final KnowledgeElement.Properties kprop)
295                         throws MissedPropertyException, InvalidPropertyException,
296                         MultiplyDefinedException {
297                 KnowledgeElement kelm = null;
298                 try {
299                         long aScenarioId = aScenarioDTO.getIndex();
300                         if (LOG.isDebugEnabled()) {
301                                 LOG.debug("Add a knowledge element to the scenario #"
302                                                 + aScenarioId);
303                         }
304                         // Get the persistent scenario.
305                         Scenario aScenario = getScenarioDAO().get(aScenarioId);
306                         // Get persistent objects for creating a new knowledge.
307                         // TODO: Actions must use DTO instead of persistent objects.
308                         getUserDAO().merge(kprop.getAuthor());
309                         getKnowledgeElementTypeDAO().merge(kprop.getType());
310                         // Create a transient knowledge element related to the given scenario.
311                         kelm = new KnowledgeElement(kprop.setOwnerScenario(aScenario));
312                         // Save the new knowledge in the database.
313                         getKnowledgeElementDAO().create(kelm);
314                         // Update scenario transient data.
315                         if (kelm.getType().equals("usecase")) {
316                                 aScenarioDTO.setUcase(kelm);
317                         } else if (aScenarioDTO.getKnowledgeElementsList() != null) { // If null, knowl will be initialized when needed
318                                 aScenarioDTO.getKnowledgeElementsList().add(kelm);
319                         }
320
321                         // Load the workflow for the parent study to take into account
322                         // all study actors durng reindexing.
323                         getStudyService().loadWorkflow(aScenario.getOwnerStudy());
324
325                         // Update the lucene index of knowledge elements.
326                         getIndexService().add(kelm);
327                         if (LOG.isDebugEnabled()) {
328                                 LOG.debug("A knowledge element #" + kelm.getIndex()
329                                                 + " is added to the scenario #" + aScenario.getIndex());
330                         }
331                 } catch (IOException error) {
332                         LOG.error("Unable to index the knowedge element '"
333                                         + kelm.getIndex() + "', reason:", error);
334                         kelm = null;
335                 }
336
337                 return kelm;
338         }
339
340         /**
341          * Update the scenario in the database.
342          * 
343          * @param aScenario
344          *            the scenario to update
345          * @return true if updating succeeded
346          */
347         @Transactional
348         private boolean update(final Scenario aScenario) {
349                 boolean isOk = false;
350                 try {
351                         getScenarioDAO().update(aScenario); // Update of relational base
352                         isOk = true;
353                 } catch (Exception error) {
354                         LOG.error("Unable to re-index the knowledge element '"
355                                         + aScenario.getIndex() + "', reason:", error);
356                 }
357                 return isOk;
358         }
359
360         /**
361          * {@inheritDoc}
362          * 
363          * @see org.splat.service.ScenarioService#checkin(org.splat.dal.bo.som.Scenario)
364          */
365         public void checkin(final Scenario aScenario) {
366                 aScenario.setUser(null);
367                 aScenario.setLastModificationDate(Calendar.getInstance().getTime());
368                 getScenarioDAO().update(aScenario);
369         }
370
371         /**
372          * {@inheritDoc}
373          * 
374          * @see org.splat.service.ScenarioService#checkout(org.splat.dal.bo.som.Scenario, org.splat.dal.bo.kernel.User)
375          */
376         public boolean checkout(final Scenario aScenario, final User user) {
377                 if (!getStudyService().isStaffedBy(aScenario.getOwnerStudy(), user)) {
378                         return false;
379                 }
380
381                 aScenario.setUser(user);
382                 aScenario.setLastModificationDate(Calendar.getInstance().getTime());
383                 getScenarioDAO().update(aScenario);
384                 return true;
385         }
386
387         /**
388          * {@inheritDoc}
389          * 
390          * @see org.splat.service.ScenarioService#copyContentsUpTo(org.splat.dal.bo.som.Scenario, org.splat.som.Step)
391          */
392         public void copyContentsUpTo(final Scenario scenario, final Step lastep) {
393                 Scenario base = (Scenario) lastep.getOwner();
394                 Step[] from = getProjectElementService().getSteps(base);
395                 Step[] to = getProjectElementService().getSteps(scenario);
396                 for (int i = 0; i < from.length; i++) {
397                         Step step = from[i];
398                         if (step.getNumber() > lastep.getNumber()) {
399                                 break;
400                         }
401
402                         List<Publication> docs = step.getAllDocuments();
403                         for (Iterator<Publication> j = docs.iterator(); j.hasNext();) {
404                                 Publication doc = getPublicationService().copy(j.next(),
405                                                 scenario); // Creation of a new reference to the document
406                                 // Database.getSession().save(doc); Publications MUST be saved later through cascading when saving the scenario
407                                 getStepService().add(to[i], doc);
408                         }
409                         List<SimulationContext> ctex = step.getAllSimulationContexts();
410                         for (Iterator<SimulationContext> j = ctex.iterator(); j.hasNext();) {
411                                 getStepService().addSimulationContext(to[i], j.next());
412                         }
413                 }
414         }
415
416         /**
417          * {@inheritDoc}
418          * 
419          * @see org.splat.service.ScenarioService#isEmpty(org.splat.dal.bo.som.Scenario)
420          */
421         public boolean isEmpty(final Scenario scenario) {
422                 Step[] mystep = getProjectElementService().getSteps(scenario);
423                 boolean isEmp = true;
424                 for (int i = 0; i < mystep.length; i++) {
425                         if (mystep[i].isStarted()) {
426                                 isEmp = false;
427                                 break;
428                         }
429                 }
430                 return isEmp;
431         }
432
433         /**
434          * @param scenario
435          * @return
436          */
437         public boolean isFinished(final Scenario scenario) {
438                 Step[] mystep = getProjectElementService().getSteps(scenario);
439                 boolean notempty = false; // If this is empty, this is not finished
440                 for (int i = 0; i < mystep.length; i++) {
441                         if (!mystep[i].isStarted()) {
442                                 continue;
443                         }
444                         if (!mystep[i].isFinished()) {
445                                 return false;
446                         }
447                         notempty = true;
448                 }
449                 return notempty;
450         }
451
452         /**
453          * {@inheritDoc}
454          * 
455          * @see org.splat.service.StudyService#addScenario(org.splat.dal.bo.som.Study, org.splat.dal.bo.som.Scenario.Properties)
456          */
457         @Transactional
458         public Scenario addScenario(final Study aStudy,
459                         final Scenario.Properties sprop) throws MissedPropertyException,
460                         InvalidPropertyException, MultiplyDefinedException {
461                 if (sprop.getManager() == null) {
462                         sprop.setManager(aStudy.getAuthor());
463                 }
464
465                 Scenario scenario = new Scenario(sprop.setOwnerStudy(aStudy));
466                 if (sprop.getBaseStep() != null) {
467                         copyContentsUpTo(scenario, sprop.getBaseStep());
468                 }
469                 Scenario previous = sprop.getInsertAfter();
470
471                 if (previous == null) {
472                         aStudy.getScenariiList().add(scenario);
473                 } else {
474                         aStudy.getScenariiList().add(
475                                         aStudy.getScenariiList().indexOf(previous) + 1, scenario);
476                 }
477                 getStudyDAO().update(aStudy); // No need to update the Lucene index
478                 getScenarioDAO().create(scenario); // Must be done after updating this study because of the back reference to the study
479                 if (sprop.getBaseStep() != null) {
480                         // No need to update the Knowledge Element index as Knowledge Elements are not copied
481                         getProjectElementService().refresh(scenario); // Because saving the scenario changes the hashcode of copied Publications
482                 }
483                 KnowledgeElementType ucase = getKnowledgeElementTypeService()
484                                 .selectType("usecase");
485                 KnowledgeElement.Properties kprop = new KnowledgeElement.Properties();
486                 User admin = getUserService().selectUser(1); // First user created when creating the database
487                 kprop.setType(ucase).setTitle(aStudy.getTitle()).setValue(
488                                 scenario.getTitle()).setAuthor(admin); // Internal Knowledge Element required by the validation process of
489                 // knowledges
490                 addKnowledgeElement(scenario, kprop);
491                 return scenario;
492         }
493
494         /**
495          * Remove a knowledge element from a scenario.
496          * 
497          * @param scenario
498          *            the scenario
499          * @param kelm
500          *            the knowledge element to remove
501          * @return true if removal succeeded
502          */
503         public boolean removeKnowledgeElement(final Scenario scenario,
504                         final KnowledgeElement kelm) {
505                 KnowledgeElement torem = scenario.getKnowledgeElement(kelm.getIndex());
506                 if (torem == null) {
507                         return false;
508                 }
509                 boolean done = scenario.getKnowledgeElements().remove(torem);
510                 if (done) {
511                         // Update of my transient data
512                         // RKV: These transient data are not used indeed.
513                         // RKV: List<KnowledgeElement> kelms = scenario.getKnowledgeByType().get(
514                         // RKV: kelm.getType().getIndex());
515                         // RKV: kelms.remove(torem);
516                         if (scenario.getKnowledgeElementsList() != null) {
517                                 scenario.getKnowledgeElementsList().remove(torem);
518                         }
519                         getScenarioDAO().update(scenario);
520                         // TODO: If the owner study is not private, remove the knowledge from the Lucene index
521                         return true;
522                 } else {
523                         return false;
524                 }
525         }
526
527         /**
528          * Get the knowledgeElementDAO.
529          * 
530          * @return the knowledgeElementDAO
531          */
532         public KnowledgeElementDAO getKnowledgeElementDAO() {
533                 return _knowledgeElementDAO;
534         }
535
536         /**
537          * Set the knowledgeElementDAO.
538          * 
539          * @param knowledgeElementDAO
540          *            the knowledgeElementDAO to set
541          */
542         public void setKnowledgeElementDAO(
543                         final KnowledgeElementDAO knowledgeElementDAO) {
544                 _knowledgeElementDAO = knowledgeElementDAO;
545         }
546
547         /**
548          * Get the indexService.
549          * 
550          * @return the indexService
551          */
552         public IndexService getIndexService() {
553                 return _indexService;
554         }
555
556         /**
557          * Set the indexService.
558          * 
559          * @param indexService
560          *            the indexService to set
561          */
562         public void setIndexService(final IndexService indexService) {
563                 _indexService = indexService;
564         }
565
566         /**
567          * Get the scenarioDAO.
568          * 
569          * @return the scenarioDAO
570          */
571         public ScenarioDAO getScenarioDAO() {
572                 return _scenarioDAO;
573         }
574
575         /**
576          * Set the scenarioDAO.
577          * 
578          * @param scenarioDAO
579          *            the scenarioDAO to set
580          */
581         public void setScenarioDAO(final ScenarioDAO scenarioDAO) {
582                 _scenarioDAO = scenarioDAO;
583         }
584
585         /**
586          * Get the studyDAO.
587          * 
588          * @return the studyDAO
589          */
590         public StudyDAO getStudyDAO() {
591                 return _studyDAO;
592         }
593
594         /**
595          * Set the studyDAO.
596          * 
597          * @param studyDAO
598          *            the studyDAO to set
599          */
600         public void setStudyDAO(final StudyDAO studyDAO) {
601                 _studyDAO = studyDAO;
602         }
603
604         /**
605          * Get the knowledgeElementTypeService.
606          * 
607          * @return the knowledgeElementTypeService
608          */
609         public KnowledgeElementTypeService getKnowledgeElementTypeService() {
610                 return _knowledgeElementTypeService;
611         }
612
613         /**
614          * Set the knowledgeElementTypeService.
615          * 
616          * @param knowledgeElementTypeService
617          *            the knowledgeElementTypeService to set
618          */
619         public void setKnowledgeElementTypeService(
620                         final KnowledgeElementTypeService knowledgeElementTypeService) {
621                 _knowledgeElementTypeService = knowledgeElementTypeService;
622         }
623
624         /**
625          * Get the studyService.
626          * 
627          * @return the studyService
628          */
629         public StudyService getStudyService() {
630                 return _studyService;
631         }
632
633         /**
634          * Set the studyService.
635          * 
636          * @param studyService
637          *            the studyService to set
638          */
639         public void setStudyService(final StudyService studyService) {
640                 _studyService = studyService;
641         }
642
643         /**
644          * Get the userService.
645          * 
646          * @return the userService
647          */
648         public UserService getUserService() {
649                 return _userService;
650         }
651
652         /**
653          * Set the userService.
654          * 
655          * @param userService
656          *            the userService to set
657          */
658         public void setUserService(final UserService userService) {
659                 _userService = userService;
660         }
661
662         /**
663          * Get the userDAO.
664          * 
665          * @return the userDAO
666          */
667         public UserDAO getUserDAO() {
668                 return _userDAO;
669         }
670
671         /**
672          * Set the userDAO.
673          * 
674          * @param userDAO
675          *            the userDAO to set
676          */
677         public void setUserDAO(final UserDAO userDAO) {
678                 _userDAO = userDAO;
679         }
680
681         /**
682          * Get the knowledgeElementTypeDAO.
683          * 
684          * @return the knowledgeElementTypeDAO
685          */
686         public KnowledgeElementTypeDAO getKnowledgeElementTypeDAO() {
687                 return _knowledgeElementTypeDAO;
688         }
689
690         /**
691          * Set the knowledgeElementTypeDAO.
692          * 
693          * @param knowledgeElementTypeDAO
694          *            the knowledgeElementTypeDAO to set
695          */
696         public void setKnowledgeElementTypeDAO(
697                         final KnowledgeElementTypeDAO knowledgeElementTypeDAO) {
698                 _knowledgeElementTypeDAO = knowledgeElementTypeDAO;
699         }
700
701         /**
702          * Get the simulationContextService.
703          * 
704          * @return the simulationContextService
705          */
706         public SimulationContextService getSimulationContextService() {
707                 return _simulationContextService;
708         }
709
710         /**
711          * Set the simulationContextService.
712          * 
713          * @param simulationContextService
714          *            the simulationContextService to set
715          */
716         public void setSimulationContextService(
717                         final SimulationContextService simulationContextService) {
718                 _simulationContextService = simulationContextService;
719         }
720
721         /**
722          * Get project settings.
723          * 
724          * @return Project settings service
725          */
726         private ProjectSettingsService getProjectSettings() {
727                 return _projectSettings;
728         }
729
730         /**
731          * Set project settings service.
732          * 
733          * @param projectSettingsService
734          *            project settings service
735          */
736         public void setProjectSettings(
737                         final ProjectSettingsService projectSettingsService) {
738                 _projectSettings = projectSettingsService;
739         }
740
741 }