The abstract base class for handling authentication.
Specific HTTP Authentication mechanisms are implemented by its subclasses, but applications never need to be aware of the specific subclasses being used.
Example: Authentication, sync:
public static int main (string[] args) {
// Create a session:
Soup.Session session = new Soup.Session ();
// Register authentication handler:
int counter = 0;
session.authenticate.connect ((msg, auth, retrying) => {
if (counter < 3) {
if (retrying == true) {
print ("Invalid user name or password.\n");
}
print ("Username: ");
string username = stdin.read_line ();
print ("Password: ");
string passwd = stdin.read_line ();
auth.authenticate (username, passwd);
counter++;
}
});
print ("URL: ");
string url = stdin.read_line ();
// Send a request:
Soup.Message msg = new Soup.Message ("GET", url);
if (msg == null) {
print ("Invalid URL\n");
return 0;
}
session.send_message (msg);
// Process the result:
print ("Status Code: %u\n", msg.status_code);
return 0;
}valac --pkg libsoup-2.4 authentication-sync.valaExample: Authentication, async:
public static int main (string[] args) {
MainLoop loop = new MainLoop ();
print ("URL: ");
string url = stdin.read_line ();
print ("Username: ");
string username = stdin.read_line ();
print ("Password: ");
string passwd = stdin.read_line ();
// Create a session:
Soup.Session session = new Soup.Session ();
// Register authentication handler:
session.authenticate.connect ((msg, auth, retrying) => {
if (retrying == false) {
print ("Start authetnication:\n");
// Simulate asynchronous input / time consuming operations:
// See GLib.IOSchedulerJob for time consuming operations
Timeout.add_seconds (10, () => {
print ("Authentication\n");
auth.authenticate (username, passwd);
// Resumes HTTP I/O on msg:
session.unpause_message (msg);
return false;
}, Priority.DEFAULT);
// Pauses HTTP I/O on msg:
session.pause_message (msg);
}
});
// Send a request:
Soup.Message msg = new Soup.Message ("GET", url);
if (msg == null) {
print ("Invalid URL\n");
return 0;
}
session.queue_message (msg, (sess, mess) => {
// Process the result:
print ("Status Code: %u\n", mess.status_code);
loop.quit ();
});
loop.run ();
return 0;
}valac --pkg libsoup-2.4 authentication-async.vala