Numa arquitectura por camadas, os blocos (Controller, View e Model) da framework ASP.NET MVC fazem parte da camada de apresentação.

No entanto, hoje em dia as aplicações web são construidas com AngularJS ou ReactJS do lado do cliente e ASP.NET Core (Web API) do lado do servidor. O que é, então, a camada de apresentação neste tipo de arquitectura?


Esta arquitectura tem as seguintes camadas:

• Apresentação
• Serviço
• Lógica de Negócio/Núcleo da aplicação
• Acesso a dados/Persistência

Camada de apresentação

Esta camada compreende as componentes, templates e modelos de AngularJS definidos na aplicação AngularJS. Estes são os artefactos da camada de apresentação.

Camada de Serviço

No âmbito de uma arquitectura por camadas, o serviço funciona como um wrapper da aplicação e disponibiliza as funcionalidades através de uma API com a qual a UI pode interagir. Esta camada vem fazer a ponte entre a camada de apresentação e a camada de negócio. Trata-se de serviços lógicos.

Portanto, a camada de serviço está repartida por duas componentes físicas: o cliente (os serviços HTTP do AngularJS) e o servidor (os controllers do ASP.NET Core). Os serviços do AngularJS e os controllers do ASP.NET Core são bastante coesos. Os métodos destes serviços comunicam directamente com os endpoints dos controllers do ASP.NET Core. Ex: MyService.getDataList().

app.service('MyService', function () {
  this.getDataList = function () {
    //...
   $.ajax({
       type : 'POST',
   //...
  };
});

Camada da lógica de negócio

Os controllers do ASP.NET Core usam as interfaces com o(s) repositório(s), as classes de domínio e os serviços. Estes são os artefactos da camada de negócio.

É aqui que está o núcleo da aplicação, independente quer da framework de apresentação quer da framework de persistência.

A implementação dos repositórios é da responsabilidade da camada de acesso a dados.

Os serviços são responsáveis pela orquestração. Exemplo:

PhotoService.AddPhoto()

//...
// Save file
var uploadsPath = Path.Combine(host.WebRoot, "uploads");
if (!Directory.Exists(uploadsPath))
    Directory.CreateDirectory(uploadsPath);
 
var fileName = Guid.NewGuid().ToString() + Path.GetExtension(file.FileName);
var filePath = Path.Combine(uploadsPath, fileName);
 
using (var stream = new FileStream(filePath, FileMode.Create))
{  
    file.Copyto(stream);
}
 
// Add a record to the repository
var photo = new Photo { FileName = fileName };
photoRepository.Add(photo);
unitOfWork.Complete(); 

Isto é separação de conceitos. E temos a Clean Architecture do Uncle Bob.

Camada de acesso a dados

Esta camada é responsável pela persistência. É aqui que temos as frameworks O/RM (no caso da Entity Framework, o DbContext pertence a esta camada) e a implementação das software patterns Unit Of Work e Repository.


Ver aqui vídeo com a implementação das software patterns Repository e Unit Of Work usando a Entity Framework.


Relacionados:
A POPULARIDADE DO ANGULARJS
.NET CORE E ASP.NET 5 (COM TUTORIAL)
ANGULARJS: SERVICE VS FACTORY






fonte: Programming with Mosh

Relacionado DevOps pela Microsoft, Gestão da Mudança

NSubstitute é uma framework de simulação em .NET. O NSubstitute cria substitutos de tipos para testes que tanto podem ser mocks (verificação das invocações) como stubs (configuração dos resultados das invocações).

Através de uma sintaxe "fluente", o NSubstitute cria substitutos de tipos para testes que podem ser configurados para retornar resultados específicos das invocações ou podem ser consultados sobre as invocações recebidas.

O NSubstitute está concebido para testes AAA Arrange-Act-Assert.

Exemplo de utilização

Pré-requisitos

• .NET Framework 3.5 ou mais recente
• Adição de Projecto de Testes Unitários à Solução .Net
• Instalação do NSubstitute através de package NuGet ou transferindo e adicionando uma referência para o ficheiro NSubstitute.dll ao projecto de testes unitários

Pressupostos

Conhecimentos de IoC

Utilização

Adicionar à classe de testes:

using NSubstitute;

Testar a Interface

   [TestClass]
    public class BusStopAppServiceTests
    {
        
        private readonly IBusStopAppService _busStopAppService;
  
        public BusStopAppServiceTests()
        {
            //Fake repository
            var busstops = new List<BusStop>
                         {
                             new BusStop {Name = "LIVERPOOL"},
                             new BusStop {Name = "LIVERPOOL LIME STREET"},
                             new BusStop {Name = "PADDINGTON"},
                             new BusStop {Name = "DARTFORD"},
                             new BusStop {Name = "DARTMOUTH"},
                             new BusStop {Name = "TOWER HILL"},
                             new BusStop {Name = "DERBY"}

                         };

            //Create the fake bus stop repository
            var busRepository = Substitute.For<IBusStopRepository>);
            var cacheManager = Substitute.For<ICacheManager>();

            //Arrange
            busRepository.GetAllList().Returns(busstops);
 
            //Create AppService by providing the fake repository
            _busStopAppService = new BusStopAppService(busRepository, cacheManager);
        }

        [TestMethod]
        public void Return_next_characters_when_busstop_known()
        {
            //Arrange
            var _lookup = "DART";
            var expectedCharacterArray = new string[] {"f", "m" };

            //Act
            var result = _busStopAppService.GetBusStopList(_lookup);

            //Assert
            CollectionAssert.AreEqual(result.Select(t => t.NextCharacter).Distinct().ToArray(), expectedCharacterArray);
        }

        [TestMethod]
        public void Return_matched_busstops_when_busstop_known()
        {
            //Arrange
            var _lookup = "LIVERPOOL";
            var expectedListCount = 2;

            //Act
            var result = _busStopAppService.GetBusStopList(_lookup);

            //Assert
            Assert.IsTrue(result.Count().Equals(expectedListCount));
        }

        [TestMethod]
        public void Return_next_empty_character_when_busstop_known()
        {
            //Arrange
            var _lookup = "TOWER";
            var expectedCharacter = " ";

            //Act
            var result = _busStopAppService.GetBusStopList(_lookup);

            //Assert
            Assert.AreEqual(result.FirstOrDefault().NextCharacter, expectedCharacter);
        }

        [TestMethod]
        public void Return_no_results_when_search_busstop_unknown()
        {
            //Arrange
            var _lookup = "KINGS CROSS";

            //Act
            var result = _busStopAppService.GetBusStopList(_lookup);

            //Assert
            Assert.IsTrue(result.Count().Equals(0));
        }
        
    }

Resultado

Outras frameworks de substituição (mocking frameworks) para .NET

• Rhino Mocks
• moq
• Simple Mocking
• Microsoft Fakes

Referência: Unit Testing with NSubstitute

What is Service Design? por Richard Ekelman

Quando temos duas cafeterias ao lado uma da outra e vendem exactamente o mesmo café, exactamente ao mesmo preço, Service Design é que nos faz entrar numa e não na outra.

Tendo como base as metodologias do Design, o Service Design ou Design de Serviços trabalha no sentido de entender o perfil dos consumidores, os seus desejos e necessidades a fim de garantir que determinado serviço é competitivo para o mercado e relevante para quem o usa.

Os Service Designers são especialistas com origem em diversas disciplinas: designers de produto, designers gráficos, designers de UX, consultores de IT e criam uma framework que determina como um serviço vai funcionar.

in O que é Service Design?

Empresas referência no Design

Growin Innovation - Design de Serviços


                                      InnovAgency - Digital Business Enabler

Apresenta-se uma solução para consumo de web service de tecnologia .NET Framework 2.0 por componente COM para tipos complexos.

Pré-requisitos

• Projecto .NET do tipo biblioteca
• Selecção a opção "Make assembly COM-Visible" na "Assembly Information" da biblioteca
• Selecção da opção "Register for COM interop" para ambiente de desenvolvimento compatível com projectos COM
• Adição ao projecto da referência web (Web Reference) para geração de código baseado nos web services da .NET Framework 2.0

Exemplo: Obtenção de documento em formato binário a partir de plataforma de Gestão Documental e gravação em sistema de ficheiros para consumo por aplicação externa.


Proxy para sistema remoto

public class SGDDocument
{
  public SGDDocument() { }

  public SGDWebService.HeaderType headerType { get; set; }
  public SGDWebService.GetDocContentBody docContentBody { get; set; }

  public string Url { get; set; }

  public string Get()
  {

  SGDWebService.GetDocContent doc = new SGDWebService.GetDocContent();
  doc.Header = headerType;
  doc.Body = docContentBody;

  SGDWebService.SGDWebService_V3HttpService service = new SGDWebService.SGDWebService_V3HttpService();
  service.Url = Url;

  SGDWebService.GetDocContentResponse docContentResponse = service.GetDocContent(doc);

  SGDWebService.GetDocContentBodyResponse docContentBodyResponse = docContentResponse.Body;

  string type = docContentBodyResponse.Type;

  SGDWebService.DocContentType docContext = docContentBodyResponse.ContextData as SGDWebService.DocContentType;
  SGDWebService.SuccessDataType successData = docContentBodyResponse.Item as SGDWebService.SuccessDataType;

  if ("E".Equals(type))
  {
  SGDWebService.ErrorDataType errorData = docContentBodyResponse.Item as SGDWebService.ErrorDataType;
  return string.Format("Ocorreu um erro na obtenção do documento: {0} {1}.", 
      errorData.Title.GetValue(0).ToString(), errorData.Detail.GetValue(0).ToString());
  }

  string dirFicheiro = System.IO.Path.Combine(AppDomain.CurrentDomain.BaseDirectory, docContext.DocFileName);
  File.WriteAllBytes(dirFicheiro, docContext.DocContent);

  return dirFicheiro;
  }

}

COM Consumer/Wrapper function

Public Function GetDocContent(ByVal FileID As Double) As String
Dim SGDDocument As SGDService.SGDDocument
Dim headerType As SGDService.headerType
Dim getDocContentBody As SGDService.getDocContentBody

Dim docFullName, destFullName As String
Dim guid1, guid2 As String

On Error GoTo errHandler

guid1 = Trim$(GetGUID())
guid1 = Mid(guid1, 2, Len(guid1) - 3)

guid2 = Trim$(GetGUID())
guid2 = Mid(guid2, 2, Len(guid2) - 3)

Set headerType = New SGDService.headerType

headerType.Version = <version>
headerType.TimeStamp = DateTime.Now
headerType.MessageGuid = guid1
headerType.GeneratorEntity = <Entity>
headerType.GeneratorApplication = <Application>
headerType.ServiceId = "<webservice>/GetDocContent"
headerType.InternalId = guid2

''Operation Input Parameteres (in this example)
Set getDocContentBody = New SGDService.getDocContentBody

getDocContentBody.Conversion = 1
getDocContentBody.DocID = CStr(FileID)
getDocContentBody.docPage = 0
getDocContentBody.system_name = <Document Management System Name>

''Prepare call to service proxy
Set SGDDocument = New SGDService.SGDDocument
Set SGDDocument.headerType = headerType
Set SGDDocument.docContentBody = getDocContentBody

SGDDocument.Url = <SGD_WEBSERVICE_URL>

''Get Document from service proxy
docFullName = SGDDocument.Get()

''Save document to working directory
destFullName = BuildPath(gsWorkDir, GetFileName(docFullName))

MoveFile docFullName, destFullName

GetDocContent = destFullName

Exit Function
errHandler:

''Error Handling TODO

  GetDocContent = vbNullString

End Function

Invocação

Dim strFileC As String

''Get document using encapsulation
strFileC = GetDocContent(<FileDocID>)

Debug.Print strFileC

XML definido na norma para desenho e implementação do serviço

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:serv="http://www.dummyComp.pt/TargetWebService" xmlns:comp="http://www.dummyComp.pt/DummyCompService">
<soapenv:Header/>
<soapenv:Body>
<serv:GetDocContent>
<Header>
<acor:Version>1</acor:Version>
<acor:TimeStamp>2013-10-01T16:07:03.388Z</acor:TimeStamp>
<acor:MessageGuid>25892e17-80f6-415f-9c65-7395632f0223</acor:MessageGuid>
<acor:GeneratorEntity>MyEntity</acor:GeneratorEntity>
<acor:GeneratorApplication>MyApplication</acor:GeneratorApplication>
<acor:ServiceId>TargetWebService/GetDocContent</acor:ServiceId>
</Header>
<Body>
<system_name>DocumentManagementSystemName</system_name>
<docId>286284628</docId>
<docPage>0</docPage>
<conversion>0</conversion>
</Body>
</serv:GetDocContent>
</soapenv:Body>
</soapenv:Envelope>

Registo da assembly para interacção com componentes COM

C:\windows\Microsoft.NET\Framework\v2.0.50727\RegAsm.exe WebServiceProxy.dll /tlb:WebServiceProxy.tlb

Cancelar registo da assembly

C:\windows\Microsoft.NET\Framework\v2.0.50727\RegAsm.exe /unregister WebServiceProxy.dll