User:Ccw: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 3: Line 3:


== ==
== ==
=2011 October 22=
=2011 October 30=
==How do you solve a problem like my server stalling?==
==Notes for new ACL request system==
''Answer: coroutines and threaded database access''


=====Propose 3 new database access functions:=====
====In the resource meta.xml:====
==dbQuery==  
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
handle dbQuery( sting query )
<aclrequest>
    <right name="function.kickPlayer" access="true"></right>
    <right name="function.banPlayer" access="true"></right>
</aclrequest>
</syntaxhighlight>
</syntaxhighlight>
*'''dbQuery''' starts a database query and returns a handle


==dbPoll==
<syntaxhighlight lang="lua">
table dbPoll( handle[, int timeout = 0, bool autoFree = true ] )
</syntaxhighlight>
*'''dbPoll''' returns the result of the query started with the supplied handle, or nil if the query has not completed yet. Setting timeout above 0 will make the function wait a bit longer if the query is not ready. A timeout of -1 will make it wait for ever. If autoFree is true, the query handle gets automatically freed when '''dbPoll''' is able to return a result


==dbFree==  
====Console command 'aclrequest'====
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
dbFree( handle )
aclrequest list
</syntaxhighlight>
> aclrequest: resname has 2 aclrequest(s) of which 2 are pending
*'''dbFree''' makes a handle go away and never come back


aclrequest list resname
> aclrequest: resname [pending] for function.kickPlayer
> aclrequest: resname [pending] for function.banPlayer


===Example usage of the above three functions:===
aclrequest deny resname all
Perform a query such as UPDATE, without waiting for the result (super fast)
> aclrequest: resname function.kickPlayer changed to deny (Console)
<syntaxhighlight lang="lua">function dbQueryExec(...)
> aclrequest: resname function.banPlayer changed to deny (Console)
    local handle = dbQuery(...)
    dbFree(handle)
end</syntaxhighlight>


aclrequest allow resname function.kickPlayer
> aclrequest: resname function.kickPlayer changed to allow (Console)


Perform a query such as SELECT, and wait for the result (super slow)
aclrequest list resname
<syntaxhighlight lang="lua">function dbQueryResult(...)
> aclrequest: resname [allow] for function.kickPlayer (by Console on 2011-11-29)
    local handle = dbQuery(...)
> aclrequest: resname [deny] for function.banPlayer (by Console on 2011-11-29)
    return dbPoll(handle,-1)
</syntaxhighlight>
end</syntaxhighlight>




Perform a query such as SELECT, and yield until the result is ready (avoids server stalling, but must be called in a coroutine)
====Script function #1:====
<syntaxhighlight lang="lua">function dbQueryLatent(...)
<syntaxhighlight lang="lua">
    local handle = dbQuery(...)
table getResourceACLRequests ( resource theResource )</syntaxhighlight>
    local result
    do
        coroutine.yield()
        result = dbPoll(handle)
    until result ~= nil
    return result
end</syntaxhighlight>


table return example:
<syntaxhighlight lang="lua">
{ {name="function.kickPlayer", access="true", pending="false", who="Console", date="2011-11-29" },
  {name="function.banPlayer", access="false", pending="false", who="Console", date="2011-11-29" } }
</syntaxhighlight>




== ==
====Script function #2:====
=2011 October 2=
<syntaxhighlight lang="lua">
==Master Plan 8012==
bool updateResourceACLRequest ( resource theResource, string rightName, bool access, string byWho )</syntaxhighlight>


===Outline===
This only works with right names that are returned from getResourceACLRequests.<br>
To enhance MTA, keeps devs motivated and ensure stuff actually gets tested and used, I propose that features developed in the trunk be backported to the current version where possible.
Calling updateResourceACLRequest automatically sents the 'pending' to false and also sets the 'date'.


===Problem===
However, when scripters start to use the new features, there will be compatibility problems with some servers & clients.
===Solution===
Therefore I present to you 'Master Plan 8012', which is:
* When a script is loaded into a server, its minimum version requirement is evaluated.
** If the script requires an updated server, it should not run and instead inform the server owner to update
** When the script is running, connecting clients below the script required minimum version are auto-updated
==== Benefits of this plan are:====
* Scripters can use latest functions and not worry about checking version numbers and such
* Server owners can use any scripts without have to worry about setting <minclientversion> etc
* And more players will update because they will have a compelling reason to do so. (i.e. To join fav server)


====Permissions====
The following are protected by default and will need an entry in the ACL:
<syntaxhighlight lang="lua">function.updateResourceACLRequest
command.aclrequest
</syntaxhighlight>




Revision as of 00:44, 30 November 2011

Coder.gif This user is an MTA developer

2011 October 30

Notes for new ACL request system

In the resource meta.xml:

<aclrequest>
    <right name="function.kickPlayer" access="true"></right>
    <right name="function.banPlayer" access="true"></right>
</aclrequest>


Console command 'aclrequest'

aclrequest list
> aclrequest: resname has 2 aclrequest(s) of which 2 are pending

aclrequest list resname
> aclrequest: resname [pending] for function.kickPlayer
> aclrequest: resname [pending] for function.banPlayer

aclrequest deny resname all
> aclrequest: resname function.kickPlayer changed to deny (Console)
> aclrequest: resname function.banPlayer changed to deny (Console)

aclrequest allow resname function.kickPlayer
> aclrequest: resname function.kickPlayer changed to allow (Console)

aclrequest list resname
> aclrequest: resname [allow] for function.kickPlayer (by Console on 2011-11-29)
> aclrequest: resname [deny] for function.banPlayer (by Console on 2011-11-29)


Script function #1:

table getResourceACLRequests ( resource theResource )

table return example: 

{ {name="function.kickPlayer", access="true", pending="false", who="Console", date="2011-11-29" },
  {name="function.banPlayer", access="false", pending="false", who="Console", date="2011-11-29" } }


Script function #2:

bool updateResourceACLRequest ( resource theResource, string rightName, bool access, string byWho )

This only works with right names that are returned from getResourceACLRequests.
Calling updateResourceACLRequest automatically sents the 'pending' to false and also sets the 'date'.


Permissions

The following are protected by default and will need an entry in the ACL: 

function.updateResourceACLRequest 
command.aclrequest


Release dates

History

Version Date Highlights User comments
1.0 22 August 2009 First release DP2 was better
1.0.1 02 October 2009 Crash fixes and less lag 1.0 was better
1.0.2 24 October 2009 Crash fixes 1.0.1 was better
1.0.3 17 December 2009 Sync improved 1.0.2 was better
1.0.4 (r1752) 7 June 2010 Security improved 1.0.3 was better
1.0.4 (r1854) 10 July 2010 Crash fixes It crashes more
1.0.4 (r2033) 14 October 2010 Crash fixes It crashes more
1.0.4 (r2106) 14 December 2010 Browser improved +
1.0.5 (r2488) 27 March 2011 AC improved It crashes more & 1.0.4 was better
1.0.5 (r2519/2520) 4 April 2011 Performance fixed 'It's almost as good as 1.0.2 now'
1.0.5 (r2560) 16 April 2011 Performance improvements
1.1.0 25 August 2011 Many new features Possibly the worst thing that has happened in the history of the world
1.1.1 20 September 2011 Accumulation of post release fixes Lags more than 1.1


Retrieved from "https://wiki.multitheftauto.com/wiki/User:Ccw?oldid=28512"