[Azure雲端服務及應用開發]_創建Azure Storage帳戶使用Table存取(NoSQL)_不同地點會咖秀(台語)_添加至特定群組機制_part4

-



牛頓:「如果我能看得更遠， 那是因為站在巨人的肩膀上。」
波頓:「侏儒站在巨人的肩膀上，便能比巨人看得更遠。」


目前雖然已經達成能透過SignalR收發機制
但是仍缺少一些比方群組設定，有各自隱私的交談功能。
因為目前還是一個廣播給所有都連上SignalR Hub的User
都會看到的粗略設計


在此對ChatMessage擴充一個屬性叫作GroupName

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
using System;
using System.Collections.Generic;
using System.Text;

namespace KYChat.Messages
{
    public class ChatMessage
    {
        public string Id { get; set; }
        public Type TypeInfo { get; set; }
        public DateTime TimeStamp { get; set; }
        public string Sender { get; set; }
        public string GroupName { get; set; }

        public ChatMessage() { }

        public ChatMessage(string sender)
        {
            Id = Guid.NewGuid().ToString();
            TypeInfo = GetType();
            Sender = sender;
            TimeStamp = DateTime.Now;
        }
    }
}

依樣畫葫蘆這次我們要擴充新的加入群組的Function

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
using System;
using System.Collections.Generic;
using System.Text;

namespace KYChat.Core
{
    public static class Config
    {
        public static string MainEndPoint = "http://localhost:7071";
        public static string NegotiateEndPoint = $"{MainEndPoint}/api/negotiate";
        public static string MessageEndPoint = $"{MainEndPoint}/api/Messages";
        public static string AddToGroupEndPoint = $"{MainEndPoint}/api/AddToGroup";
    }
}
在Chat.Functions專案之下
創建一個新的Azure Function項目，選HTTP Trigger 並命名為AddToGroup。
Authorization Level一樣是選匿名的Anonymous
(建立的函式可以由任何用戶端觸發，而不需提供金鑰。)

刪掉函數中程式內容並修改函數的部分結構
經初步改寫後

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
using System;
using System.IO;
using System.Threading.Tasks;
using Microsoft.AspNetCore.Mvc;
using Microsoft.Azure.WebJobs;
using Microsoft.Azure.WebJobs.Extensions.Http;
using Microsoft.AspNetCore.Http;
using Microsoft.Extensions.Logging;
using Newtonsoft.Json;
using Microsoft.Azure.WebJobs.Extensions.SignalRService;

namespace KYChat.Functions
{
    public static class AddToGroup
    {
        [FunctionName("AddToGroup")]
        public static async Task Run(
            [HttpTrigger(AuthorizationLevel.Anonymous, "get", "post", Route = null)] HttpRequest req,
            [SignalR(HubName = "chat")] IAsyncCollector<SignalRGroupAction> signalRGroupActions,
            ILogger log)
        {
            
        }
    }
}


Step1.回傳型態改為Task 用async修飾
回傳型態改為Task 採用異步修飾
擴充傳入參數 
型態為IAsyncCollector 泛型指向SignalRGroupAction
前綴用SignalR修飾指向自己設的SignalR Hub名稱




在此由於之前的ChatMessage  資料型態不太足夠
因此我們需要再額外擴充新的自訂型態
於Chat.Message專案下新增一個新的Message Type 
名字為 UserConnectionMessage 繼承自之前寫的ChatMessage
for識別
某User是否已進到群組了還是出群組了呢....
有該群組特定的Token (不好意思進來之前請先講通關密語的概念喔~~)
UserConnectionMessage程式碼

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
using System;
using System.Collections.Generic;
using System.Text;

namespace KYChat.Messages
{
    public class UserConnectedMessage : ChatMessage
    {
        public string Token { get; set; }
        public bool IsEntered { get; set; }

        public UserConnectedMessage(){}

        public UserConnectedMessage(string userName,string groupName) : base(userName)
        {
            GroupName = groupName;
        }
    }
}



Step2.由於我們需要存用戶群組相關資料因此需要使用到
Azure Storage的 帳戶當中的Table來做存取

Azure Table本身採用一種NoSQL存取模式(Key-Attribute Value)
跟筆者之前研究的Redis有點類似概念
(更多Redis介紹可以參考如下連結共寫了四篇介紹)



屬於Schema Free你不需要先花時間去規劃Table Schema
一種 NoSQL PaaS服務
一個Table就好比如很多Entity 的集合體
一個Entity就是很多屬性的集合體(Class Model物件實體)
每一筆Entity最大可高達1MB
如果是更高階的使用需求(或有更多預算)
可採用Cosmos DB 每一筆Entity可到2MB




選擇左側Create a resource
移到最下方選擇Storage Account


這裡選擇
一般用途 v2 帳戶
然後Replication 選LRS ---> 因為咖秀(台語) 備份機制會都只能在同一Data Center
Hot Access 

地區這裡選美國東部、當然日本東部也都可
這裡筆者也都用定價計算查過這幾個點的Data Center都 咖秀(台語)
(注意!!!   地區不同收費是有差異的)


價格估算資料(微軟Azure官網):

12 個月免費項目當中看起來是不包含Storage Account當中的Table 項目呀
也不含儲存體帳戶 QQ






這裡操作方式都很一致性、簡單
創建好後我們到Resources




去建立一個Table 命名為Users











Step3.將AddToGroup的Azure Function程式完善

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
using System;
using System.IO;
using System.Threading.Tasks;
using Microsoft.AspNetCore.Mvc;
using Microsoft.Azure.WebJobs;
using Microsoft.Azure.WebJobs.Extensions.Http;
using Microsoft.AspNetCore.Http;
using Microsoft.Extensions.Logging;
using Newtonsoft.Json;
using Microsoft.Azure.WebJobs.Extensions.SignalRService;
using KYChat.Messages;

namespace KYChat.Functions
{
    public static class AddToGroup
    {
        [FunctionName("AddToGroup")]
        public static async Task Run(
            [HttpTrigger(AuthorizationLevel.Anonymous, "get", "post", Route = null)] HttpRequest req,
            [SignalR(HubName = "chat")] IAsyncCollector<SignalRGroupAction> signalRGroupActions,
            ILogger log)
        {
            var message = new JsonSerializer()
                .Deserialize<UserConnectedMessage>(new JsonTextReader(new StreamReader(req.Body)));

            
            await signalRGroupActions.AddAsync(new SignalRGroupAction
            {
                ConnectionId = message.Token,
                UserId = message.Sender,
                GroupName = message.GroupName,
                Action = GroupAction.Add
            }) ;

        }
    }
}


Message的回傳資料處理和上一篇Part3依樣畫葫蘆
先透過StreamReader將Body最原始Stream處理後轉成StreamReader
再接棒給JsonTextReader處理返回JsonReader後
才最終交給JsonSerializer去Deserialize回Object

再把該Object轉字串後
再做DeserializeObject動作轉為UserConnectedMessage的型態
進行相關屬性的設置

最後透過IAsyncCollector<SignalRGroupAction> (代表群組物件的集合)
調用AddAsync
加入的資料型態為 SignalRGroupAction 
將使用者新增至群組

Step4.接著我們要來下載安裝Azure Storage套件
對Chat.Functions專案右鍵開啟Nuget套件管理
搜尋
microsoft.azure.webjobs.extensions.storage
然後下載安裝(這裡用之前的3.0.1版本，看到Preview版本可能會有不太穩定成熟的風險。)


回到AddToGroup
添加回傳修飾字串


TableAttributes
在此設置好我們想access的Table名稱跟連線字串


連線字串首先到azure portal面板
Home -> All resources (秀出目前所有創建的資源) -> 點選方才建立Storage Account
->選擇 Access Keys


copy到我們的Chat.Function專案下的local.settings.json
新增額外連線用的字串


Step5.到專案下建立Models folder
新增UserEntity Class
繼承TableEntity

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
using Microsoft.WindowsAzure.Storage.Table;
using System;
using System.Collections.Generic;
using System.Text;

namespace KYChat.Functions.Models
{
    public class UserEntity : TableEntity
    {
        public string UserId { get; set; }
        public string Room { get; set; }
        public string Color { get; set; }
        public string Avatar { get; set; }

    }
}


主要設置幾個基本屬性
用戶識別ID、進入的聊天群組名稱、對話字顏色、大頭照存放檔案名

AddToGroup最終程式

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
using System;
using System.IO;
using System.Threading.Tasks;
using Microsoft.AspNetCore.Mvc;
using Microsoft.Azure.WebJobs;
using Microsoft.Azure.WebJobs.Extensions.Http;
using Microsoft.AspNetCore.Http;
using Microsoft.Extensions.Logging;
using Newtonsoft.Json;
using Microsoft.Azure.WebJobs.Extensions.SignalRService;
using KYChat.Messages;
using KYChat.Functions.Models;

namespace KYChat.Functions
{
    public static class AddToGroup
    {
        [FunctionName("AddToGroup")]
        [return: Table("Users",Connection = "StorageConnectionString")]
        public static async Task<UserEntity> Run(
            [HttpTrigger(AuthorizationLevel.Anonymous, "get", "post", Route = null)] HttpRequest req,
            [SignalR(HubName = "chat")] IAsyncCollector<SignalRGroupAction> signalRGroupActions,
            ILogger log)
        {
            var message = new JsonSerializer()
                .Deserialize<UserConnectedMessage>(new JsonTextReader(new StreamReader(req.Body)));

            
            await signalRGroupActions.AddAsync(new SignalRGroupAction
            {
                ConnectionId = message.Token,
                UserId = message.Sender,
                GroupName = message.GroupName,
                Action = GroupAction.Add
            }) ;

            Random r = new Random();
            var red = r.Next(0, 255).ToString("X2");
            var green = r.Next(0, 255).ToString("X2");
            var blue = r.Next(0, 255).ToString("X2");

            var item = new UserEntity
            {
                UserId = message.Sender,
                Room = message.GroupName,
                Color = $"#{red}{green}{blue}",
                Avatar = $"image_{r.Next(1,51)}.png",
                PartitionKey = message.GroupName,
                RowKey = message.Sender
            };
            return item;
        }
    }
}

之後是針對Chat.Core專案的擴充微調
Step1.到Config多增加EndPoint  for 加入群組

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
using System;
using System.Collections.Generic;
using System.Text;

namespace KYChat.Core
{
    public static class Config
    {
        public static string MainEndPoint = "http://localhost:7071";
        public static string NegotiateEndPoint = $"{MainEndPoint}/api/negotiate";
        public static string MessageEndPoint = $"{MainEndPoint}/api/Messages";
        public static string AddToGroupEndPoint = $"{MainEndPoint}/api/AddToGroup";
    }
}


Step2.到IChatService補擴充規格 JoinChannelAsync

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
using KYChat.Messages;
using System;
using System.Collections.Generic;
using System.Text;
using System.Threading.Tasks;

namespace KYChat.Core.Services
{
    public interface IChatService
    {
        bool IsConnected { get; }
        string ConnectionToken { get; set; }
        Task InitAsync(string userId);
        Task DisconnectionAsync();
        Task SendMessageAsync(ChatMessage message);
        Task JoinChannelAsync(UserConnectedMessage message);
    }
}


Step3.ChatService補實作具體加入群組行動

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
using KYChat.Core.EventHandlers;
using KYChat.Core.Models;
using KYChat.Messages;
using Microsoft.AspNetCore.SignalR.Client;
using Newtonsoft.Json;
using System;
using System.Collections.Generic;
using System.Diagnostics;
using System.Net.Http;
using System.Text;
using System.Threading;
using System.Threading.Tasks;

namespace KYChat.Core.Services
{
    public class ChatService : IChatService
    {
        public bool IsConnected { get; set; }

        public string ConnectionToken { get; set; }

        private SemaphoreSlim semaphoreSlim = new SemaphoreSlim(1, 1);

        private HttpClient httpClient;

        HubConnection hub;

        public event EventHandler<MessageEventArgs> OnReceiveMessage;

        public async Task InitAsync(string userId)
        {
            await semaphoreSlim.WaitAsync();

            if (httpClient == null)
            {
                httpClient = new HttpClient();
            }
            var result = await httpClient.GetStringAsync($"{Config.NegotiateEndPoint}/{userId}");

            var info = JsonConvert.DeserializeObject<ConnectionInfo>(result);

            var connectionBuilder = new HubConnectionBuilder();

            connectionBuilder.WithUrl(info.Url, (obj) =>
             {
                 obj.AccessTokenProvider = () => Task.Run(() => info.AccessToken);
             });

            hub = connectionBuilder.Build();

            await hub.StartAsync();

            ConnectionToken = hub.ConnectionId;

            IsConnected = true;

            hub.On<object>("ReceiveMessage", (message) =>
            {
                var strJson = message.ToString();
                var obj = JsonConvert.DeserializeObject<ChatMessage>(strJson);
                var msg = (ChatMessage)JsonConvert.DeserializeObject(strJson, obj.TypeInfo);
                OnReceiveMessage?.Invoke(this, new MessageEventArgs(msg));
            });

            semaphoreSlim.Release();
        }

        public async Task DisconnectionAsync()
        {
            if (!IsConnected)
                return;

            try
            {
                await hub.DisposeAsync();
            }
            catch (Exception ex)
            {
                Debug.WriteLine(ex);
            }
            IsConnected = false;
        }

        public async Task SendMessageAsync(ChatMessage message)
        {
            if (!IsConnected)
            {
                throw new NotImplementedException("Not connected!!");
            }

            var strJson = JsonConvert.SerializeObject(message);

            var content = new StringContent(strJson, Encoding.UTF8, "application/json");

            await httpClient.PostAsync(Config.MessageEndPoint, content);
        }

        public async Task JoinChannelAsync(UserConnectedMessage message)
        {
            if (!IsConnected)
                return;
            message.Token = ConnectionToken;

            message.IsEntered = true;

            var strJson = JsonConvert.SerializeObject(message);

            var content = new StringContent(strJson, Encoding.UTF8, "application/json");

            await httpClient.PostAsync(Config.AddToGroupEndPoint, content);

            await SendMessageAsync(message);
        }
    }
}


目前我們已將添加至聊天室群組功能函數完成
但還要能夠取得目前有的群組(有點像聊天包廂列表)


到Chat.Core專案的Models目錄再新增
Room的實體Class

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
using System;
using System.Collections.Generic;
using System.Text;

namespace KYChat.Core.Models
{
    public class Room
    {
        public string Name { get; set; }
        public string Image { get; set; }
        public int UsersNumber { get; set; }

    }
}

一項聊天群組可能需要
一特定群組名稱
一個特定的照片(參考Line的設計)
其他可能用戶數等等

到IChatService補擴充Spec  再定義 GetRooms()

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
using KYChat.Core.Models;
using KYChat.Messages;
using System;
using System.Collections.Generic;
using System.Text;
using System.Threading.Tasks;

namespace KYChat.Core.Services
{
    public interface IChatService
    {
        bool IsConnected { get; }
        string ConnectionToken { get; set; }
        Task InitAsync(string userId);
        Task DisconnectionAsync();
        Task SendMessageAsync(ChatMessage message);
        Task JoinChannelAsync(UserConnectedMessage message);

        Task<List<Room>> GetRooms();
    }
}

到ChatService程式區塊補實作
這裡暫時先寫死自定義幾個群組 

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
public async Task<List<Room>> GetRooms()
        {
            var rooms = new List<Room>
            {
                new Room
                {
                    Name = "公司",
                    Image = "company.png"
                },
                new Room
                {
                    Name = "家庭",
                    Image = "family.png"
                },
                new Room
                {
                    Name = "朋友",
                    Image = "friend.png"
                },
                new Room
                {
                    Name = "部門群組",
                    Image = "department.png"
                }
            };
            return rooms;
        }


最終我們回到Chat.Client 測試專案
進行微調
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
using KYChat.Core.Services;
using KYChat.Messages;
using System;
using System.Threading.Tasks;

namespace KYChat.Client
{
    class Program
    {
        static ChatService myService;
        static string userName;
        static string room;

        static async Task Main(string[] args)
        {
            Console.WriteLine("User Name:");
            userName = Console.ReadLine();

            myService = new ChatService();
            myService.OnReceiveMessage += MyService_OnReceiveMessage;

            await myService.InitAsync(userName);
            Console.WriteLine("You are connected now !!");

            await JoinRoom();

            bool IsKeepGoing = true;
            do
            {
                var text = Console.ReadLine();
                if (text.Trim().ToLower().Equals("exit"))
                {
                    await myService.DisconnectionAsync();
                    IsKeepGoing = false;
                }
                else
                {
                    var message = new SimpleTextMessage(userName)
                    {
                        Text = text
                    };
                    await myService.SendMessageAsync(message);
                }
            } while (IsKeepGoing);


        }

        private static async Task JoinRoom()
        {
            var rooms = await myService.GetRooms();
            Console.WriteLine("===聊天群組列表===");
            foreach (var room in rooms)
            {
                Console.WriteLine(room.Name);
            }
            Console.WriteLine("請輸入想進入的聊天群組:");
            room = Console.ReadLine();
            var message = new UserConnectedMessage(userName, room);
            await myService.JoinChannelAsync(message);
        }

        private static void MyService_OnReceiveMessage(object sender, Core.EventHandlers.MessageEventArgs e)
        {
            if (e.Message.Sender == userName)
                return;
            if (e.Message.TypeInfo.Name == nameof(SimpleTextMessage))
            {
                var simpleText = e.Message as SimpleTextMessage;
                var message = $"{simpleText.Sender}: {simpleText.Text}";
                Console.WriteLine(message);
            }
            else if (e.Message.TypeInfo.Name == nameof(UserConnectedMessage))
            {
                var userConnected = e.Message as UserConnectedMessage;
                string message = string.Empty;
                if (userConnected.IsEntered)
                {
                    message = $"{userConnected.Sender} 已進入群組";
                }
                else
                {
                    message = $"{userConnected.Sender} 已離開群組";
                }
                Console.WriteLine(message);
            }
        }
    }
}


主要於已連線後多一個副程式JoinRoom()
進行聊天群組列表的打印
對OnReceiveMessage 委派指向的副程式MyService_OnReceiveMessage
當中再穿插一段判斷是否進入群組的邏輯
當傳入UserConnectedMessage資料型態的時候

之後回到Chat.Functions專案下去修改
傳入的型別部分擴充判斷
因為之前是用SimpleTextMessage
並沒有我們新增的Bool Flag IsEntered屬性

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
using System;
using System.IO;
using System.Threading.Tasks;
using Microsoft.AspNetCore.Mvc;
using Microsoft.Azure.WebJobs;
using Microsoft.Azure.WebJobs.Extensions.Http;
using Microsoft.AspNetCore.Http;
using Microsoft.Extensions.Logging;
using Newtonsoft.Json;
using Microsoft.Azure.WebJobs.Extensions.SignalRService;
using KYChat.Messages;

namespace KYChat.Functions
{
    public static class Messages
    {
        [FunctionName("Messages")]
        public static async Task Run(
            [HttpTrigger(AuthorizationLevel.Anonymous, "post")] HttpRequest req,
            [SignalR(HubName = "chat")] IAsyncCollector<SignalRMessage> signalRMessages,
            ILogger log)
        {
            var serializedObject = new JsonSerializer().Deserialize(new JsonTextReader(new StreamReader(req.Body)));

            //var message = JsonConvert.DeserializeObject<SimpleTextMessage>(serializedObject.ToString());// before

            var message = JsonConvert.DeserializeObject<ChatMessage>(serializedObject.ToString());
            if (message.TypeInfo.Name == nameof(SimpleTextMessage))
            {
                message = JsonConvert.DeserializeObject<SimpleTextMessage>(serializedObject.ToString());
            }
            else if (message.TypeInfo.Name == nameof(UserConnectedMessage))
            {
                message = JsonConvert.DeserializeObject<UserConnectedMessage>(serializedObject.ToString());
            }

            await signalRMessages.AddAsync(new SignalRMessage
            {
                Target = "ReceiveMessage",
                Arguments = new[] { message }
            });
        }
    }
}


最終就能達成Console版本的聊天群組控管程式雛形了









Ref:


Azure Functions 的 Azure 資料表儲存體繫結

Azure Table計價

Introduction to Table storage in Azure

Azure Storage documentation

Quickstart: Create an Azure Storage table in the Azure portal

留言

張貼留言

這個網誌中的熱門文章

何謂淨重(Net Weight)、皮重(Tare Weight)與毛重(Gross Weight)

-
圖片
當談到貨物的重量時，往往會分成所謂的淨重(Net Weight)與毛重(Gross Weight)。 會有以下公式關係存在 淨重=毛重-皮重(包裝物的重量) 毛重=淨重+皮重 淨重( Net Weight 縮寫為N.W.) 指物品本身的重量，不包括容器或包裝材料的重量。 凈重是國際貿易中最常見的計重辦法。 例如，如果運輸原材料，原材料的重量就是所運輸貨物的淨重。包裝原材料的容器或包裝不計入淨重。同樣地，當我們考慮一罐豆子時，罐子內所含物品的重量就算作淨重。因此，淨重將包括豆子、罐頭里的任何液體，以及保存豆子所含的物品。 大多數 以重量為計價的貨物買賣 ，採用此計價方法。 若合同中並未明確規範以何種方式計量和計價時，按慣例以凈重計價。 毛重( Gross Weight 縮寫G.W.) 貨物連同它的包裝的重量，是你托運的所有物品的總重量。 皮重(Tare Weight) 指商品外包裝材料的重量(即運輸包裝的重量)，不包括內包裝材料和襯墊物的重量。 比方一個空的貨櫃、容器、或任何包裝材料的重量。 Net Net Weight純淨重 (指從Net Weight中扣除內包裝後的重量) 進出口商品為了因應運輸及消費需求, 一般都有內包裝與外包裝。 一般在買賣合同與信用狀中,通常只要求於裝箱單上註明Gross Weight和Net Weight即可, 但有些L/C 要求 Net Net Weight,大多是海關徵收從量稅時的依據 運輸重量對於航運業或者航空運輸等各自都通用這些術語 為何特別在意重量? 主要就在於會影響像是傳輸安全乘載限制。 就運輸層面(不同方式的運輸) 航空運輸：對機長而言，毛重包括皮重、產品淨重以及飛機、燃料、乘客和機組人員的重量。 公路/鐵路運輸:對於火車車長而言，毛重包括產品淨重、皮重和運輸車輛的重量。 水路航運運輸：對船長而言，毛重就是淨重和皮重之和。 就公司ERP成本角度 成本一般都會採用 "淨重" 主要是因為若用毛重，可能會有輔材不可控因素存在 比方一個 5cm 固定塑膠件，今天用一個 10cm 紙箱測重，明天用一個 100cm 紙箱測重，那可能就容易導致ERP資料比較會失真。 就物流層面來探討 通常還會有一名詞即所謂「實際重量」(Actual Weight) 根據稱重(過磅)所得到的重量，實際重量分為實際毛重(Gross Weig
閱讀完整內容

Architecture(架構) 和 Framework(框架) 有何不同?_軟體設計前的事前規劃的藍圖概念

-
圖片
一個應用程式(軟體) 不管是  互動拍照 也好、 投影也好、車牌偵測... 舞台演唱會後方電視牆的互動應用程序、 粒子特效、3D或2D遊戲  等等 開發者通常都需要在一開始做規劃 ㄟ  假設我今天要寫 跟影像有關 可能需要偵測、可能需要提取前景、可能需要偵測圓形 之類的 我有  emgucv 、AForge.Net、 opencv 等等可以用 但是 假設我今天要做的應用程序是需要有視窗介面的~~ emgucv 跟 C# windows form 媒合性 就很高 而且直接在 visual studio 做開發 opencv 我可能還需要依賴 Qt 之類等等  framework 假設我今天是要寫一個 演唱會電視牆互動粒子特效 可能就會挑   openframeworks  、 processing 、kinect 來寫互動 Achitecture  --->全稱 :  Software Architecture   軟體架構 Achitecture   由好多 framework 組成 軟體架構（Software Architecture）是一種軟體在開發前的設計藍圖， 用來告訴軟體的結構，功能，介面，用法，與其他系統的構連以及資料交換等等規範， 但它並沒有叫你要用什麼方式實作， 因此軟體架構通常會產生文件，圖樣，原型以及規格等， 就是沒有可用的程式碼，因為那不是軟體架構應該有的東西， 就像蓋房子時是給你藍圖，而不是一幢蓋好的房子。 軟體框架（Framework):是一個已經成形的方法，而且有程式碼實體 （例如鋼構工法也是要有鋼材才能做），並且會告訴你要如何使用它 （即 Framework Documentation，MSDN Library 即為一最佳例子）
閱讀完整內容

(2021年度)駕訓學科筆試準備題庫歸納分析_法規是非題

-
圖片
  若是出現 「必須」、「必需」、「...必...」、「應由」、「應先」、「應...」 則很高機率是圈 是非通常只要是如下字眼 「不必」+動詞 、「不需」「不須」、「可不」、「可以不」、「可立即」 有出現或符合的都選叉 (X)1.違規記點又不登記在駕照上，所以可以 不必理會 而任意違反交通規則。 (X)2.發生重大交通事故，為迅速恢復交通，清除現場，可 不必等待 肇事處理機關之指示，即可進行。 (X)3.道路駕駛練習，行車前 不必實施 車輛安全檢查，因為那是駕駛教練的工作。 (X)4.開車前， 不必檢查 機件安全，但在行駛中要隨時注意儀錶功能顯示，確保行車安全。 (X)5.煞車油若經常低於"MIN"線，只要添加即可， 不必到修理廠檢修 。 (X)6.冷卻系統只要副水箱在滿水位，主水箱 不必檢查 也不會有問題。 (X)7.引擎冷卻水內含有防凍液或防銹劑，可 不必更換 。 (X)8.儀錶板上的「燃油油量錶」之指針高度，已經降低至「E」點，橘色的「低油料警示燈」點亮時， 不必急著加油 ，到達目的地後再行補充燃油即可。 (X)9.有安全氣囊裝備的汽車， 不必繫 安全帶。 (X)10.煞車時有異音，是正常的情況， 不必檢修 。 (X)11.汽車定期檢驗 不必檢驗 車輛故障標誌，所以隨車不一定要帶車輛故障標誌。 (X)12.開車時 不必理會 義交之指揮，一切以號誌為主。 (X)13.汽車經過隧道，因隧道內燈光明亮視線良好，為省電可 不必開亮 頭燈。 (X)14.駕駛人只求技術優良，對遵守交通規則 不必太重視 。 (X)15.在開車前， 不必檢查 機件，以免耽誤行車時間。 (X)16.遇幼童專用車、校車、身心障礙者用特製車或教練車， 不必禮讓 。 (X)17.行車 不必攜帶 隨車工具。 (X)18.行車起駛前進， 不必顯示 方向燈。 (X)19.汽車通過鐵路平交道，前後兩車間， 不必保持 距離。 (X)20.夜間將車輛停放在無燈光設備及照明不清之道路時，亦 不必顯示 停車燈光或反光標識。 (X)21.在夜間或有霧靄、雨雪、風沙及晝晦時，把車輛停在路旁， 不必顯示 停車燈光或反光標識。 (X)22.汽車駕駛人，僅需具有優良駕駛技術， 不需 具備急救的常識和技能。 (X)23.汽車車身、引擎、底盤、電系等重要設備變更或調換時， 不需 向公路主管機關申請臨時檢驗。
閱讀完整內容