Make all patch return the new entity.

2 files changed, 27 insertions, 19 deletions

diff --git a/Timeline/Services/TimelineService.cs b/Timeline/Services/TimelineService.cs
index 85445973..0ea68265 100644
--- a/Timeline/Services/TimelineService.cs
+++ b/Timeline/Services/TimelineService.cs
@@ -81,21 +81,6 @@ namespace Timeline.Services
         Task DeletePost(string name, long id);

 

         /// <summary>

-        /// Set the properties of a timeline. 

-        /// </summary>

-        /// <param name="name">Username or the timeline name. See remarks of <see cref="IBaseTimelineService"/>.</param>

-        /// <param name="newProperties">The new properties. Null member means not to change.</param>

-        /// <exception cref="ArgumentNullException">Thrown when <paramref name="name"/> or <paramref name="newProperties"/> is null.</exception>

-        /// <exception cref="ArgumentException">Thrown when <paramref name="name"/> is illegal. It is not a valid timeline name (for normal timeline service) or a valid username (for personal timeline service).</exception>

-        /// <exception cref="TimelineNotExistException">

-        /// Thrown when timeline does not exist.

-        /// For normal timeline, it means the name does not exist.

-        /// For personal timeline, it means the user of that username does not exist

-        /// and the inner exception should be a <see cref="UserNotExistException"/>.

-        /// </exception>

-        Task ChangeProperty(string name, TimelinePatchRequest newProperties);

-

-        /// <summary>

         /// Remove members to a timeline.

         /// </summary>

         /// <param name="name">Username or the timeline name. See remarks of <see cref="IBaseTimelineService"/>.</param>

@@ -235,6 +220,23 @@ namespace Timeline.Services
         /// Thrown when the user does not exist. Inner exception MUST be <see cref="UserNotExistException"/>.

         /// </exception>

         Task<BaseTimelineInfo> GetTimeline(string username);

+

+        /// <summary>

+        /// Set the properties of a timeline. 

+        /// </summary>

+        /// <param name="name">Username or the timeline name. See remarks of <see cref="IBaseTimelineService"/>.</param>

+        /// <param name="newProperties">The new properties. Null member means not to change.</param>

+        /// <exception cref="ArgumentNullException">

+        /// Thrown when <paramref name="username"/> is null.

+        /// </exception>

+        /// <exception cref="ArgumentException">

+        /// Thrown when <paramref name="username"/> is of bad format.

+        /// </exception>

+        /// <exception cref="TimelineNotExistException">

+        /// Thrown when the user does not exist. Inner exception MUST be <see cref="UserNotExistException"/>.

+        /// </exception>

+        Task ChangeProperty(string name, TimelinePatchRequest newProperties);

+

     }

 

     public abstract class BaseTimelineService : IBaseTimelineService

diff --git a/Timeline/Services/UserService.cs b/Timeline/Services/UserService.cs
index 93d92740..7dc7159d 100644
--- a/Timeline/Services/UserService.cs
+++ b/Timeline/Services/UserService.cs
@@ -82,6 +82,7 @@ namespace Timeline.Services
         /// </summary>

         /// <param name="id">The id of the user.</param>

         /// <param name="info">The new info. May be null.</param>

+        /// <returns>The new user info.</returns>

         /// <exception cref="ArgumentException">Thrown when some fields in <paramref name="info"/> is bad.</exception>

         /// <exception cref="UserNotExistException">Thrown when user with given id does not exist.</exception>

         /// <remarks>

@@ -96,13 +97,14 @@ namespace Timeline.Services
         /// 

         /// </remarks>

         /// <seealso cref="ModifyUser(string, User)"/>

-        Task ModifyUser(long id, User? info);

+        Task<User> ModifyUser(long id, User? info);

 

         /// <summary>

         /// Modify a user's info.

         /// </summary>

         /// <param name="username">The username of the user.</param>

         /// <param name="info">The new info. May be null.</param>

+        /// <returns>The new user info.</returns>

         /// <exception cref="ArgumentNullException">Thrown when <paramref name="username"/> is null.</exception>

         /// <exception cref="ArgumentException">Thrown when <paramref name="username"/> is of bad format or some fields in <paramref name="info"/> is bad.</exception>

         /// <exception cref="UserNotExistException">Thrown when user with given id does not exist.</exception>

@@ -120,7 +122,7 @@ namespace Timeline.Services
         /// Note: Whether <see cref="User.Version"/> is set or not, version will increase and not set to the specified value if there is one.

         /// </remarks>

         /// <seealso cref="ModifyUser(long, User)"/>

-        Task ModifyUser(string username, User? info);

+        Task<User> ModifyUser(string username, User? info);

 

         /// <summary>

         /// Delete a user of given id.

@@ -370,7 +372,7 @@ namespace Timeline.Services
         }

 

 

-        public async Task ModifyUser(long id, User? info)

+        public async Task<User> ModifyUser(long id, User? info)

         {

             ValidateModifyUserInfo(info);

 

@@ -382,9 +384,11 @@ namespace Timeline.Services
 

             await _databaseContext.SaveChangesAsync();

             _logger.LogInformation(LogDatabaseUpdate, ("Id", id));

+

+            return CreateUserFromEntity(entity);

         }

 

-        public async Task ModifyUser(string username, User? info)

+        public async Task<User> ModifyUser(string username, User? info)

         {

             if (username == null)

                 throw new ArgumentNullException(nameof(username));

@@ -400,6 +404,8 @@ namespace Timeline.Services
 

             await _databaseContext.SaveChangesAsync();

             _logger.LogInformation(LogDatabaseUpdate, ("Username", username));

+

+            return CreateUserFromEntity(entity);

         }

 

         public async Task<bool> DeleteUser(long id)