-
A Conceptual Framework for API Refactoring in Enterprise Application Architectures
Authors:
Fabrizio Montesi,
Marco Peressotti,
Valentino Picotti,
Olaf Zimmermann
Abstract:
Enterprise applications are often built as service-oriented architectures, where the individual services are designed to perform specific functions and interact with each other by means of well-defined APIs (Application Programming Interfaces). The architecture of an enterprise application evolves over time, in order to adapt to changing business requirements. This evolution might require changes…
▽ More
Enterprise applications are often built as service-oriented architectures, where the individual services are designed to perform specific functions and interact with each other by means of well-defined APIs (Application Programming Interfaces). The architecture of an enterprise application evolves over time, in order to adapt to changing business requirements. This evolution might require changes to the APIs offered by services, which can be achieved through appropriate API refactorings.
Previous studies on API refactoring focused on the effects on API definitions, with general considerations on related forces and smells. So far, instead, the development strategy for realising these refactorings has received little attention. This paper addresses exactly this aspect.
We introduce a conceptual framework for the implementation of API refactorings. Our framework elicits that there are important trade-offs and choices, which significantly affect the efficiency, maintainability, and isolation properties of the resulting architecture. We validate our framework by implementing several refactorings that introduce established API patterns with different choices, which illustrates the guiding principles offered by our framework. Our work also elicits, for the first time, how certain programming language features can reduce friction in applying API refactoring and open up more architectural choices.
△ Less
Submitted 10 July, 2024;
originally announced July 2024.
-
Domain-Driven Design Representation of Monolith Candidate Decompositions Based on Entity Accesses
Authors:
Miguel Levezinho,
Stefan Kapferer,
Olaf Zimmermann,
António Rito Silva
Abstract:
Microservice architectures have gained popularity as one of the preferred architectural approaches to develop large-scale systems, replacing the monolith architecture approach. Similarly, strategic Domain-Driven Design (DDD) gained traction as the preferred architectural design approach for the development of microservices. However, DDD and its strategic patterns are open-ended by design, leading…
▽ More
Microservice architectures have gained popularity as one of the preferred architectural approaches to develop large-scale systems, replacing the monolith architecture approach. Similarly, strategic Domain-Driven Design (DDD) gained traction as the preferred architectural design approach for the development of microservices. However, DDD and its strategic patterns are open-ended by design, leading to a gap between the concepts of DDD and the design of microservices. This gap is especially evident in migration tools that identify microservices from monoliths, where candidate decompositions into microservices provide little in terms of DDD refactoring and visualization. This paper proposes a solution to this problem by extending the operational pipeline of a multi-strategy microservice identification tool, called Mono2Micro, with a DDD modeling tool that provides a language, called Context Mapper DSL (CML), for formalizing the most relevant DDD concepts. The extension maps the content of the candidate decompositions, which include clusters, entities, and functionalities, to CML constructs that represent DDD concepts such as Bounded Context, Aggregate, Entity, and Service, among others. The results are validated with a case study by comparing the candidate decompositions resulting from a real-world monolith application with and without CML translation.
△ Less
Submitted 21 June, 2024;
originally announced July 2024.
-
How Do Microservice API Patterns Impact Understandability? A Controlled Experiment
Authors:
Justus Bogner,
Pawel Wójcik,
Olaf Zimmermann
Abstract:
Microservices expose their functionality via remote Application Programming Interfaces (APIs), e.g., based on HTTP or asynchronous messaging technology. To solve recurring problems in this design space, Microservice API Patterns (MAPs) have emerged to capture the collective experience of the API design community. At present, there is a lack of empirical evidence for the effectiveness of these patt…
▽ More
Microservices expose their functionality via remote Application Programming Interfaces (APIs), e.g., based on HTTP or asynchronous messaging technology. To solve recurring problems in this design space, Microservice API Patterns (MAPs) have emerged to capture the collective experience of the API design community. At present, there is a lack of empirical evidence for the effectiveness of these patterns, e.g., how they impact understandability and API usability. We therefore conducted a controlled experiment with 6 microservice patterns to evaluate their impact on understandability with 65 diverse participants. Additionally, we wanted to study how demographics like years of professional experience or experience with MAPs influence the effects of the patterns. Per pattern, we constructed two API examples, each in a pattern version "P" and a functionally equivalent non-pattern version "N" (24 in total). Based on a crossover design, participants had to answer comprehension questions, while we measured the time. For five of the six patterns, we identified a significant positive impact on understandability, i.e., participants answered faster and / or more correctly for "P". However, effect sizes were mostly small, with one pattern showing a medium effect. The correlations between performance and demographics seem to suggest that certain patterns may introduce additional complexity; people experienced with MAPs will profit more from their effects. This has important implications for training and education around MAPs and other patterns.
△ Less
Submitted 21 February, 2024;
originally announced February 2024.
-
Design principles, architectural smells and refactorings for microservices: A multivocal review
Authors:
Antonio Brogi,
Davide Neri,
Jacopo Soldani,
Olaf Zimmermann
Abstract:
Potential benefits such as agile service delivery have led many companies to deliver their business capabilities through microservices. Bad smells are however always around the corner, as witnessed by the considerable body of literature discussing architectural smells that possibly violate the design principles of microservices. In this paper, we systematically review the white and grey literature…
▽ More
Potential benefits such as agile service delivery have led many companies to deliver their business capabilities through microservices. Bad smells are however always around the corner, as witnessed by the considerable body of literature discussing architectural smells that possibly violate the design principles of microservices. In this paper, we systematically review the white and grey literature on the topic, in order to identify the most recognised architectural smells for microservices and to discuss the architectural refactorings allowing to resolve them.
△ Less
Submitted 10 September, 2019; v1 submitted 4 June, 2019;
originally announced June 2019.
-
Which role does multiphoton interference play in small phase estimation in quantum Fourier transform interferometers?
Authors:
Olaf Zimmermann,
Vincenzo Tamma
Abstract:
Recently, quantum Fourier transform interferometers have been demonstrated to allow a quantum metrological enhancement in phase sensitivity for a small number n of identical input single photons [1-3]. However, multiphoton distinguishability at the detectors can play an important role from an experimental point of view [4]. This raises a fundamental question: How is the phase sensitivity affected…
▽ More
Recently, quantum Fourier transform interferometers have been demonstrated to allow a quantum metrological enhancement in phase sensitivity for a small number n of identical input single photons [1-3]. However, multiphoton distinguishability at the detectors can play an important role from an experimental point of view [4]. This raises a fundamental question: How is the phase sensitivity affected when the photons are completely distinguishable at the detectors and therefore do not interfere? In other words, which role does multiphoton interference play in these schemes? Here, we show that for small phase values the phase sensitivity achievable in the proposed schemes with indistinguishable photons is enhanced only by a constant factor with respect to the case of completely distinguishable photons at the detectors. Interestingly, this enhancement arises from the interference of only a polynomial number (in n) of the total n! multiphoton path amplitudes in the n-port interferometer. These results are independent of the number n of single photons and of the phase weight factors employed at each interferometer channel.
△ Less
Submitted 5 December, 2017;
originally announced December 2017.
-
Multi-Photon Interference and Metrology
Authors:
Olaf Zimmermann
Abstract:
Recently, Motes et al. proposed in Phys. Rev. Lett. 114, 170802 (2015) a linear optics interferometer with N identical single photon input states as a tool for sub-shot-noise phase estimation which does not require NOON states sources. This thesis investigates how the degree of distinguishability between the input photonic spectra affects the interferometric phase sensitivity, by employing the res…
▽ More
Recently, Motes et al. proposed in Phys. Rev. Lett. 114, 170802 (2015) a linear optics interferometer with N identical single photon input states as a tool for sub-shot-noise phase estimation which does not require NOON states sources. This thesis investigates how the degree of distinguishability between the input photonic spectra affects the interferometric phase sensitivity, by employing the results obtained by Tamma and Laibacher in Phys. Rev. Lett. 114, 243601 (2015). Remarkably, the obtained results show, that for small phases, the phase sensitivity in the case of completely distinguishable photons is identical to the one in the case of identical photons considered by Motes et al. apart from a constant factor that is independent of the number N of input photons. Consequently, multiphoton interference does not provide in the scheme proposed by Motes et al. any sub-shot-noise sensitivity for a large number N of photons.
△ Less
Submitted 15 October, 2017; v1 submitted 10 October, 2017;
originally announced October 2017.
