Obsolete:MNET 1.0 RPC: Difference between revisions
From MoodleDocs
Line 25: | Line 25: | ||
* <code>enrol_</code> | * <code>enrol_</code> | ||
For | === For modules === | ||
* | An RPC call to <code>mod_forum_dofoobar()</code> rpc call triggers: | ||
* <code>include_once(mod/forum/lib.php)</code> | |||
* check for <code>function_exists("forum_mnet_dofoobar_enabled")</code> | * check for <code>function_exists("forum_mnet_dofoobar_enabled")</code> | ||
* <code>if (forum_mnet_dofoobar_enabled())</code> | * <code>if (forum_mnet_dofoobar_enabled())</code> | ||
* then invoke <code>forum_mnet_dofoobar()</code> with the parameters received... | * then invoke <code>forum_mnet_dofoobar()</code> with the parameters received... | ||
:: | :'''Note:''' <code>mnet_</code> is an arbitrary prefix (could be rpc instead) that makes it clear that the function is for remote invocation. The <code>_enabled()</code> function must exist and return true for added security. make it really hard for a develper to expose something accidentally | ||
=== For auth and enrol plugins === | |||
An RPC call to <code>enrol_ldap_dofoobar()</code> rpc call triggers: | |||
* <code>include_once(enrol/ldap/enrol.php)</code> | |||
* instanciate the class | |||
* check for <code>method_exists($obj, "mnet_dofoobar_enabled")</code> | |||
* <code>if ($obj->mnet_dofoobar_enabled())</code> | |||
* then invoke <code>$obj->mnet_dofoobar()</code> with the parameters received... |
Revision as of 04:16, 4 September 2006
As part of the [Community hub] infrastructure, we need to define RPC calling conventions...
Moodle's APIs follow several principles that make them scalable annd flexible.
- They are "Just In Time discoverable" rather than all registered at runtime. This is a good optimization for HTTP's statelesness.
- Once an entry point is hit (a webpage in moodle, for instance) the module code author is in control. The framework doesn't limit what kinds of interactions can happen.
So we want to preserve those capabilities... Additionally, we want to make sure the RPC calls are safe, and cannot be exposed by accident.
Outline of a new mnet API
Calls can be exposed via the mnet API by
- Moodle core
- Moodle auth plugins
- Moodle enrol plugins
- Moodle modules
How the RPC calls are processed
The rpc layer expects one of several prefixes in the method name
mod_
auth_
enrol_
For modules
An RPC call to mod_forum_dofoobar()
rpc call triggers:
include_once(mod/forum/lib.php)
- check for
function_exists("forum_mnet_dofoobar_enabled")
if (forum_mnet_dofoobar_enabled())
- then invoke
forum_mnet_dofoobar()
with the parameters received...
- Note:
mnet_
is an arbitrary prefix (could be rpc instead) that makes it clear that the function is for remote invocation. The_enabled()
function must exist and return true for added security. make it really hard for a develper to expose something accidentally
For auth and enrol plugins
An RPC call to enrol_ldap_dofoobar()
rpc call triggers:
include_once(enrol/ldap/enrol.php)
- instanciate the class
- check for
method_exists($obj, "mnet_dofoobar_enabled")
if ($obj->mnet_dofoobar_enabled())
- then invoke
$obj->mnet_dofoobar()
with the parameters received...